{
  "protocolVersion": "0.3.0",
  "name": "StartShop Commerce Agent",
  "description": "Agent-to-agent commerce across StartShop merchants: search catalogs, get quotes, negotiate bundles, and BUY products end-to-end. Agents with a funded x402 USDC wallet can complete a paid order (no human checkout step) on any Shopify-connected merchant that advertises `capabilities.x402.order_settlement.enabled`. To target a specific merchant, fetch their per-merchant card at https://mljjrfrrohjynttzjlls.functions.supabase.co/a2a-card?merchant=<slug> — that card lists the merchant's exact x402 settlement network, payout wallet, per-order USD cap, AND a KEYLESS `/m/<slug>/x402_order` endpoint when the merchant has `order` in `public_scopes`. The keyless route needs no API key — just the EIP-3009 Payment-Signature header — settlement itself proves payment. Or pass `metadata.merchant_hint: \"<slug>\"` on every JSON-RPC call. The bound `acrt_...` API key already identifies a merchant — passing a hint that doesn't match returns `merchant_mismatch`.",
  "url": "https://mljjrfrrohjynttzjlls.functions.supabase.co/a2a-jsonrpc",
  "preferredTransport": "JSONRPC",
  "provider": {
    "organization": "StartShop",
    "url": "https://app.startshop.ai",
    "directory_url": "https://mljjrfrrohjynttzjlls.functions.supabase.co/a2a-card"
  },
  "version": "1.1.0",
  "documentationUrl": "https://app.startshop.ai/dashboard/a2a/docs",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "x402": {
      "order_settlement": {
        "advertised_per_merchant": true,
        "discovery_url": "https://mljjrfrrohjynttzjlls.functions.supabase.co/a2a-card?merchant=<slug>",
        "notes": "Per-merchant settlement (enabled flag, network, pay_to wallet, per-order USD cap) is advertised on the per-merchant card under capabilities.x402.order_settlement. When enabled, prefer the `x402_order` skill over `place_order` to complete a paid order in one settlement instead of returning a checkout URL. Per-merchant cards also expose a KEYLESS endpoint at `/functions/v1/a2a-rest/m/<slug>/x402_order` — callable with no API key (only the Payment-Signature header)."
      }
    }
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain", "application/json"],
  "securitySchemes": {
    "bearer": {
      "type": "http",
      "scheme": "bearer",
      "bearerFormat": "StartShop A2A API key (acrt_...)"
    }
  },
  "security": [{ "bearer": [] }],
  "skills": [
    {
      "id": "search_products",
      "name": "Search products",
      "description": "Search the merchant catalog with a free-text query.",
      "tags": ["commerce", "catalog", "search"],
      "examples": ["Find a lightweight rain jacket under $150", "Show me unisex sneakers in size 10"]
    },
    {
      "id": "quote",
      "name": "Get a quote",
      "description": "Availability + unit/line pricing for a product (and variant).",
      "tags": ["commerce", "pricing"]
    },
    {
      "id": "negotiate_bundle",
      "name": "Negotiate a bundle",
      "description": "Request a bundle discount across multiple products. May require an x402 USDC micropayment.",
      "tags": ["commerce", "discount"]
    },
    {
      "id": "place_order",
      "name": "Place an order (checkout-URL handoff)",
      "description": "Build a cart from items and return a signed checkout URL the shopper opens to pay on the merchant's gateway. This is the fallback path for agents that do NOT have a funded x402 wallet. Agents with USDC on the advertised network should prefer `x402_order` instead — it pays for the goods in one call and returns a paid order confirmation with no human checkout step.",
      "tags": ["commerce", "checkout"]
    },
    {
      "id": "x402_order",
      "name": "Pay & complete order in USDC (x402)",
      "description": "Settle the full cart total in USDC via x402 and have a paid Shopify order created automatically — no checkout URL, no human step. Available on REST `POST /x402_order`, JSON-RPC method `x402_order`, and the MCP tool `complete_order`. Two-call flow: first call (items + shipping_address + email) returns HTTP 402 / `payment_required` with PaymentRequirements whose `maxAmountRequired` already includes subtotal + shipping + tax quoted live from Shopify; retry with the signed EIP-3009 USDC payload (`Payment-Signature` header on REST/JSON-RPC, `payment_signature` field on MCP) to complete. Returns `{ order_number, shopify_order_name, total, x402: { tx_hash, network, explorer_url } }`. Per-merchant `max_order_usd` cap applies and is advertised on the per-merchant card.",
      "tags": ["commerce", "checkout", "x402", "payments"]
    }
  ],
  "additionalInterfaces": [
    { "transport": "JSONRPC", "url": "https://mljjrfrrohjynttzjlls.functions.supabase.co/a2a-jsonrpc" },
    { "transport": "MCP+HTTP", "url": "https://mljjrfrrohjynttzjlls.functions.supabase.co/a2a-mcp" },
    { "transport": "REST", "url": "https://mljjrfrrohjynttzjlls.functions.supabase.co/a2a-rest" }
  ]
}
