{
  "name": "Apparel Monster Storefront Agent",
  "description": "Agent interface for shopping on Apparel Monster — browse catalog, manage cart, complete checkout, and track orders. Backed by the Spree Commerce Storefront API v2 (REST) and a dedicated Model Context Protocol endpoint.",
  "url": "https://dfe0ea20ac20.agentic.checkouttools.com/mcp",
  "version": "1.0.0",
  "protocolVersion": "0.3.0",
  "provider": {
    "organization": "Apparel Monster",
    "url": "https://spree.apparel.monster"
  },
  "documentationUrl": "https://spree.apparel.monster/.well-known/agent-skills/index.json",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extendedAgentCard": false,
    "extensions": [
      {
        "uri": "https://github.com/google-agentic-commerce/ap2/v1",
        "description": "Apparel Monster acts as an AP2 merchant — catalog browsing, cart management, and checkout via the Spree Storefront API with partner-routed payment authorization.",
        "required": true,
        "params": {
          "roles": ["merchant"]
        }
      }
    ]
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/markdown"
  ],
  "preferredTransport": "JSONRPC",
  "supportedInterfaces": [
    {
      "transport": "JSONRPC",
      "url": "https://dfe0ea20ac20.agentic.checkouttools.com/mcp",
      "description": "Model Context Protocol endpoint (streamable-http, JSON-RPC 2.0)"
    },
    {
      "transport": "HTTP+JSON",
      "url": "https://spree.apparel.monster/api/v2/storefront",
      "description": "Spree Storefront API v2 (OpenAPI 3.0 at /api/openapi/storefront.yaml)"
    }
  ],
  "securitySchemes": {
    "oauth2": {
      "type": "oauth2",
      "description": "OAuth 2.0 via Spree doorkeeper for customer and admin flows",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://spree.apparel.monster/spree_oauth/authorize",
          "tokenUrl": "https://spree.apparel.monster/spree_oauth/token",
          "refreshUrl": "https://spree.apparel.monster/spree_oauth/token",
          "scopes": {
            "read": "Read catalog and own orders",
            "write": "Manage cart and checkout",
            "admin": "Administrative access via Platform API"
          }
        }
      }
    },
    "orderToken": {
      "type": "apiKey",
      "description": "Anonymous cart identifier issued by POST /api/v2/storefront/cart",
      "in": "header",
      "name": "X-Spree-Order-Token"
    }
  },
  "security": [
    {"oauth2": ["read", "write"]},
    {"orderToken": []}
  ],
  "skills": [
    {
      "id": "browse-catalog",
      "name": "Browse Catalog",
      "description": "Search and browse apparel products by name, taxon (category), price range, in-stock status. Lists 30 taxons across Men, Women, Sportswear, plus promotional groupings. Returns product details with variants (size/color).",
      "tags": ["shopping", "catalog", "search"],
      "inputModes": ["application/json", "text/plain"],
      "outputModes": ["application/json", "text/markdown"],
      "examples": [
        "Find men's shirts under $50",
        "Show me the denim-shirt product",
        "List all dresses on sale",
        "What categories exist?"
      ]
    },
    {
      "id": "manage-cart",
      "name": "Manage Cart",
      "description": "Create a cart (anonymous via order_token or authenticated via Bearer), add variants, change quantities, apply promo codes, view running totals.",
      "tags": ["shopping", "cart", "promotion"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "examples": [
        "Add variant 118 to my cart quantity 2",
        "Apply coupon SUMMER25",
        "What's in my cart?"
      ]
    },
    {
      "id": "checkout",
      "name": "Checkout",
      "description": "Set email, shipping/billing address, select shipping rate, add payment, complete the order. Accepts major card networks via Spree's integrated Stripe payment handler.",
      "tags": ["shopping", "checkout", "payment"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "examples": [
        "Ship to 123 Main St, Springfield, USA",
        "Use standard shipping",
        "Complete my order"
      ]
    },
    {
      "id": "track-order",
      "name": "Track Order",
      "description": "Look up order status, payment state, and fulfillment/shipment state by order number (requires order_token or authentication).",
      "tags": ["shopping", "orders", "tracking"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json", "text/markdown"],
      "examples": [
        "What's the status of order R123456789?",
        "When will my order ship?"
      ]
    },
    {
      "id": "agent-pay",
      "name": "Agent-Paid Access (x402)",
      "description": "Pay-per-request access to an agent-exclusive curated catalog slice via x402 HTTP 402 at /api/agent-access. Uses Base Sepolia USDC (testnet) — $0.05 per unlock.",
      "tags": ["x402", "micropayment", "agent-exclusive"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "examples": [
        "Pay $0.05 to access today's trending drop",
        "Redeem the agent promo code"
      ]
    }
  ]
}