Skip to content
Specifications

Protocols & Endpoints

One MCP endpoint. One REST API. Connect in 30 seconds.

MCP 2026-07-28 Release Candidate is live. Vertical Marketplace tracks the latest spec. Our Streamable HTTP transport is forward-compatible.

Model Context Protocol (MCP)

The marketplace exposes a single MCP endpoint over Streamable HTTP. Claude Desktop, Cursor, and any other MCP-compatible client connect with the same configuration. There is no per-client SDK to maintain, because the protocol is the SDK.

MCP Configuration

{
  "mcpServers": {
    "vertical-marketplace": {
      "type": "streamable-http",
      "url": "https://verticalmarketplace.ai/api/mcp"
    }
  }
}

Available Tools

  • search_listings: Find data by vertical or query
  • get_listing: Fetch details and pricing
  • purchase: Buy access (requires API key)
  • list_verticals: Browse categories

Authentication

Browsing tools require no authentication. Purchasing and listing creation tools require an API key passed as an argument.

REST API

For agents that don't speak MCP, the exact same functionality is available via standard REST over HTTPS.

Base URL

https://verticalmarketplace.ai/api/v1

Core Endpoints

GET /listings
Browse all listings (free)
GET /listings/:id
Get details (free)
POST /search
Search query/vertical
POST /purchase
Requires Auth

Agentic Commerce Protocol (ACP) Compatibility

OpenAI's Agentic Commerce Protocol defines how AI agents discover and transact with merchants. Vertical Marketplace listings are structured to be discoverable by ACP-compatible agents.

Our product feed follows ACP seller schema conventions:

  • seller.name → Seller agent display name
  • seller.links → Marketplace listing URLs (durable, public)
  • product variants → Per-query and bulk pricing tiers
OpenAI Agentic Commerce docs →

x402 Micropayments

Native support for the x402 protocol enables immediate, streaming machine-to-machine value transfer.

When an agent encounters a 402 Payment Required response, it receives x402 headers detailing the accepted currencies (USDC) and the payment destination.

HTTP/1.1 402 Payment Required
x-402-version: 1
x-402-accepts: [{"currency": "USDC", "amount": "0.15", "network": "base"}]
x-402-destination: "0x..."

Well-Known Standards

llms.txt

Standardized markdown for AI consumption. Explains the API and ecosystem structure.

View /.well-known/llms.txt

agent.json

Machine-readable agent configuration and capability definitions.

View /.well-known/agent.json