MCP.trade
Menu
MarketplaceTrade BoardPaymentsConfigurator
Connect MCPShare MCP

Hybrid monetization

Global credits on Stripe, x402 on demand

Buyers can run through Stripe-backed credit plans while keeping explicit x402 support for wallet-native and anonymous flows.

free

$0 / month

50 monthly credits

pro

$49 / month

1,000 monthly credits + 4¢ overage / credit

pro_plus

$149 / month

5,000 monthly credits + 2¢ overage / credit

Rail resolver

  • Priority in auto mode: global credits → x402 challenge.
  • Set paymentRail=x402 to force wallet-signature settlement.
  • Anonymous callers and env-key callers remain x402-only.

Creator payouts

  • Stripe-originated usage is attributed and paid through Stripe Connect.
  • x402-originated usage continues through existing x402 settlement rails.
  • Free-tier funded usage is excluded from creator payout.

Billing and payment APIs

Plans: /api/billing/plans

Status: /api/billing/status

Checkout: /api/billing/checkout

Portal: /api/billing/portal

Connect: /api/billing/connect/onboarding + /api/billing/connect/status

Webhooks: /api/billing/webhooks/stripe

x402 capability API: /api/x402/facilitator/supported

Facilitator status: ready (demo)

Agent execution quickstart

Use tool calls or direct API calls. For explicit wallet execution, passpaymentRail=x402.

Execution examples

Show curl flow
# 1) Read requirement for accepted offer
curl -s https://mcp.trade/api/trade/offers/trade_offer_3/execute

# 2) Bootstrap a server-issued challenge session (same endpoint, no payment headers)
curl -i -X POST https://mcp.trade/api/trade/offers/trade_offer_3/execute \
  -H 'content-type: application/json' \
  -d '{"task":"example","paymentRail":"x402"}'

# 3) Retry with v1 payment headers after 402 challenge
curl -i -X POST https://mcp.trade/api/trade/offers/trade_offer_3/execute \
  -H 'content-type: application/json' \
  -H 'payment-identifier: <PAYMENT_IDENTIFIER>' \
  -H 'payment-signature: <PAYMENT_SIGNATURE>' \
  -d '{"task":"example"}'

# 4) Or retry with v2 Base64 PaymentPayload
curl -i -X POST https://mcp.trade/api/trade/offers/trade_offer_3/execute \
  -H 'content-type: application/json' \
  -H 'PAYMENT-SIGNATURE: <BASE64_PAYMENT_PAYLOAD>' \
  -d '{"task":"example"}'

# 5) Auto rail execution (credits/metered/x402 fallback)
curl -i -X POST https://mcp.trade/api/trade/offers/trade_offer_3/execute \
  -H 'content-type: application/json' \
  -d '{"task":"example","paymentRail":"auto"}'

# Challenge compatibility headers from 402 responses:
# - X-MCP-Trade-Payment-Required-V1
# - X-MCP-Trade-Payment-Required-V2
# - X-MCP-Trade-X402-Detected-Mode
Open billing dashboardCreator monetizationMCP tools