Skip to content

Live Demo · No sign-up

Try the MCP without signing up

The public demo-store endpoint responds without authentication. Call search_products, browse_categories, or get_product_details directly from your agent or terminal.

Public endpoint:POST /demo-store/mcpLive

Tools available without an API key

Rate limit: 20 requests/min per IP

search_products

Search products by query, category, or price range

query: string, category?: string, min_price?: number, max_price?: number, max_results?: number

get_product_details

Get full product details, variants, and availability

product_id: string

browse_categories

List all product categories and subcategories

(no arguments)

get_merchant_profile

Merchant trust score, policies, and shipping SLA

(no arguments)

Example: Agent Transcript

Send this cURL request or use it from any MCP agent

cURL
curl https://agenticmcpstores.com/demo-store/mcp \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_products",
      "arguments": { "query": "sneakers" }
    }
  }'

Example response

{
  "products": [
    {
      "id": "prod-001",
      "title": "Nike Air Max 90",
      "price": 130,
      "currency": "USD",
      "category": "Sneakers",
      "in_stock": true,
      "vendor": "Nike",
      "rating": 4.7
    },
    {
      "id": "prod-002",
      "title": "Adidas Ultraboost 23",
      "price": 190,
      "currency": "USD",
      "category": "Sneakers",
      "in_stock": true,
      "vendor": "Adidas",
      "rating": 4.5
    },
    {
      "id": "prod-003",
      "title": "The North Face Nuptse Jacket",
      "price": 320,
      "currency": "USD",
      "category": "Jackets",
      "in_stock": true,
      "vendor": "The North Face",
      "rating": 4.8
    }
  ],
  "total": 3,
  "query": "running shoes"
}

Tool contracts / Quick Tool Test

get_merchant_profile — response fields

trust.overallScore— 0.0–1.0 — use to gate actions
trust.verificationLevel— NONE | BASIC | STANDARD | PREMIUM
policies.returns.windowDays— number — return window
policies.shipping.freeThresholdCents— number — free shipping threshold (cents)
policies.payment.acceptedMethods[]— string[] — Visa, PayPal, USDC, etc.
supportedProtocols[]— { name, mode: live|sandbox|coming_soon }
agentPolicySummary.maxCartValueUsd— number — hard ceiling per session
agentPolicySummary.confirmationRequiredAboveUsd— number — confirm threshold
agentPolicySummary.allowedShippingCountries[]— ISO-2 country list
discovery.agentPolicy— URL — fetch for full policy contract

Quick Tool Test

Click a tool — the request is sent live to the demo-store MCP endpoint. No sign-up required.

Response

Click a tool to see the live response →

Checkout tools (require API key)

create_cart
items: [{ product_id: string, quantity: number, variant_id?: string }]
get_shipping_rates
cart_id: string
select_shipping_option
cart_id: string, shipping_handle: string
apply_discount
cart_id: string, code: string
preview_checkout
cart_id: string
complete_checkout
cart_id: string, buyer?: { name, email, phone }, paymentMethod?: string

Get a free temporary key (24h): POST /api/v1/sandbox/key

complete_checkout — contract

Required inputs

cart_id: string (UUID from create_cart)

buyer?: { name, email, phone } — collected via elicitation

paymentMethod?: "STRIPE" | "PAYPAL" | "AP2" | "X402"

Response states

COMPLETED — payment processed, order_id returned

PENDING_EXTERNAL_CONFIRMATION — PayPal/AP2 buyer approval required

error.CHECKOUT_ALREADY_COMPLETED — idempotency guard (409)

Get a Sandbox Key

Checkout tools require a temporary key. Generate one without signing up:

POST /api/v1/sandbox/key
TTL: 24 hoursRate: 50 req/hourMax 3 keys per IP per day
cURL
curl -X POST https://agenticmcpstores.com/api/v1/sandbox/key \
  -H "Content-Type: application/json"

# Response:
# {
#   "key": "sandbox_abc123...",
#   "expires_at": "2026-03-23T12:00:00Z",
#   "rate_limit": "50/hour"
# }

Use the X-Agent-Api-Key header with your sandbox key for checkout tools.

Frequently Asked Questions

What is the demo store?
It is a public test MCP server with a fictional catalog. It lets you try search, checkout, and payment protocol tools without registration or authentication.
Do I need an API key?
Not for read tools (search_products, browse_categories, get_product_details, get_merchant_profile). Checkout tools require a free 24-hour temporary key obtained via POST /api/v1/sandbox/key.
Which protocols are supported?
MCP (Model Context Protocol), A2A (Agent-to-Agent), and UCP (Universal Commerce Protocol) are live in production. ACP (Stripe fiat), AP2 (Google mandates), and PayPal (Orders API v2) are available in sandbox mode. VIC (Visa cards), KYApay (identity-linked), x402 (USDC stablecoin), WebMCP, and A2UI are in development.
Is payment real?
No. All payment protocols (ACP, AP2, x402) operate in sandbox/test mode. No real charges are processed and no funds are moved.
What are the rate limits?
Read tools: 20 requests/min per IP. Sandbox keys: 50 requests/hour, max 3 keys per IP per day, each key expires after 24 hours.
How do I integrate?
Send JSON-RPC 2.0 requests to the POST /demo-store/mcp endpoint. For checkout, first obtain a sandbox key. Check the developer docs for TypeScript and Python SDKs.

Ready to connect your real store?

Create your free account and connect Shopify or WooCommerce in less than 5 minutes.

Create free accountView pricing
Live Demo — Try the MCP without signing up | AgenticMCPStores