MCP server
Connect your agent runtime to MCP.trade for listing discovery, config fetches, and trade tools.
Pick a client, copy setup config, then run a quick `tools/list` endpoint test.
Authentication mode
Anonymous mode is read-only discovery/listing/search. API key or OAuth enables using paid MCP servers.
Any MCP client config with `mcpServers`.
JSON config (JSON)
{
"mcpServers": {
"mcp-trade": {
"transport": "streamable_http",
"url": "https://mcp.trade/api/mcp"
}
}
}Call MCP.trade from external model APIs with remote MCP tools enabled.
curl https://api.openai.com/v1/responses \
-H "authorization: Bearer $OPENAI_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "<OPENAI_MODEL>",
"input": "What MCP tools are available?",
"tool_choice": "required",
"tools": [
{
"type": "mcp",
"server_label": "mcp-trade",
"server_url": "https://mcp.trade/api/mcp",
"require_approval": "never"
}
]
}'# 1) Request listing payment challenge
{
"jsonrpc": "2.0",
"id": "listing-requirement",
"method": "tools/call",
"params": {
"name": "execute_listing_payment",
"arguments": {
"listingIdOrSlug": "analytics-companion",
"buyerAddress": "0xYourWalletAddress",
"input": {
"task": "run-listing-action",
"payload": { "example": true }
}
}
}
}
# 2) Retry with payment
{
"jsonrpc": "2.0",
"id": "listing-settle",
"method": "tools/call",
"params": {
"name": "execute_listing_payment",
"arguments": {
"listingIdOrSlug": "analytics-companion",
"buyerAddress": "0xYourWalletAddress",
"paymentIdentifier": "<FROM_STEP_1>",
"paymentSignature": "<SIGNATURE>",
"input": {
"task": "run-listing-action",
"payload": { "example": true }
}
}
}
}
# 3) Poll status
{
"jsonrpc": "2.0",
"id": "listing-status",
"method": "tools/call",
"params": {
"name": "get_listing_payment_status",
"arguments": {
"paymentIdentifier": "<PAYMENT_IDENTIFIER>"
}
}
}
# Endpoint: https://mcp.trade/api/mcpStreamable HTTP URL:https://mcp.trade/api/mcp
MCP server card:https://mcp.trade/api/mcp/.well-known/mcp/server-card.json
OAuth metadata:authorization server: https://mcp.trade/api/mcp/.well-known/oauth-authorization-serverprotected resource: https://mcp.trade/api/mcp/.well-known/oauth-protected-resource
Use `GET` for discovery and `POST` for JSON-RPC calls (`initialize`, `tools/list`, `tools/call`).
Anonymous mode is read-only discovery/listing/search. API key or OAuth enables using paid MCP servers.
For higher rate limits, send an API key via `x-mcp-api-key`, `x-api-key`, or `Authorization: Bearer`. Write-capable flows also support OAuth bearer tokens with the write scope.
Trade and billing tools (`create_trade_request`, `submit_trade_offer`, `accept_trade_offer`, `get_credit_balance`, `create_billing_checkout_session`, `create_billing_portal_session`, `execute_trade_offer`, `execute_listing_payment`) require managed keys from the API keys dashboard or a token with `mcp:write:trade` scope.
curl -s https://mcp.trade/api/mcp \ -H 'x-mcp-api-key: <YOUR_MCP_API_KEY>'
Search MCP marketplace
search_marketplace
Search MCP.trade listings by query, category, tag, pricing, and trust signals.
Get MCP listing detail
get_listing
Return full detail for one marketplace listing including config payload, setup steps, and machine-usable URLs.
List trade board requests
list_trade_requests
List trade requests posted by buyers looking for MCP implementations.
Get trade request detail
get_trade_request
Return one trade request with offer summaries and execution URLs for accepted offers.
List trade offers for discovery
list_trade_offers
List trade offers with x402 and pricing metadata for agentic deal discovery and routing.
List billing plans
list_billing_plans
List MCP.trade global billing plans (free + paid tiers), included monthly credits, and overage rates.
Get credit balance
get_credit_balance
Get current credit wallet status for the managed MCP API key owner (plan, credits remaining, cycle window).
Create billing checkout session
create_billing_checkout_session
Create a Stripe-hosted checkout session for plan upgrade/subscription. Requires managed MCP API key.
Create billing portal session
create_billing_portal_session
Create a Stripe customer portal session for plan/payment-method management. Requires managed MCP API key.
Create trade request
create_trade_request
Create a new Trade Board request. Requires a managed MCP API key owned by the acting user.
Submit trade offer
submit_trade_offer
Submit an offer for a Trade Board request. Requires a managed MCP API key owned by the acting user.
Accept trade offer
accept_trade_offer
Accept a pending trade offer. Requires managed MCP API key for the request owner/admin.
Get listing payment policy
get_listing_payment_policy
Return public x402 payment policy for a listing (by slug or listing ID) when monetization is enabled.
Set listing payment policy
set_listing_payment_policy
Create or update x402 payment policy for a listing you own. Requires managed MCP API key.
Get x402 facilitator capabilities
get_payment_capabilities
Return supported payment schemes, networks, and assets from MCP.trade's x402 facilitator status endpoint.
Execute accepted trade offer
execute_trade_offer
Execute an accepted offer through MCP.trade's hybrid rail resolver (credits/x402). Call with paymentRail=auto or x402.
Get trade payment status
get_trade_payment_status
Check payment status for an x402 paymentIdentifier. Use public mode for polling (`pending`, `settled`, `failed`).
Execute listing payment flow
execute_listing_payment
Execute canonical listing flow on /api/x402/pay/{listingIdOrSlug} with hybrid rail resolution (credits/x402).
Get listing payment status
get_listing_payment_status
Check listing payment status for an x402 paymentIdentifier. Use public mode for polling (`pending`, `settled`, `failed`).