Apparel Monster Storefront Agent

{
  "name": "Apparel Monster Storefront Agent",
  "description": "Agent interface for shopping on Apparel Monster \u2014 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://apparel.monster/a2a",
  "version": "1.0.0",
  "protocolVersion": "0.3.0",
  "provider": {
    "organization": "Apparel Monster",
    "url": "https://apparel.monster"
  },
  "documentationUrl": "https://apparel.monster/.well-known/agent-skills/index.json",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "stateTransitionHistory": false,
    "extendedAgentCard": false,
    "extensions": [
      {
        "uri": "https://github.com/google-agentic-commerce/ap2/v1",
        "description": "Apparel Monster acts as an AP2 merchant \u2014 catalog browsing, cart management, and checkout via the Spree Storefront API with partner-routed payment authorization.",
        "required": true,
        "params": {
          "roles": [
            "merchant"
          ]
        }
      },
      {
        "uri": "https://apparel.monster/api/v1/openapi.yaml",
        "description": "Callbacks are signed with Ed25519 (RFC 9421 and Standard Webhooks v1a); the public key is at https://apparel.monster/.well-known/jwks.json",
        "required": false
      }
    ]
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/markdown"
  ],
  "preferredTransport": "JSONRPC",
  "supportedInterfaces": [
    {
      "transport": "JSONRPC",
      "url": "https://apparel.monster/a2a",
      "description": "A2A JSON-RPC \u2014 conversational catalogue discovery via message/send."
    },
    {
      "transport": "HTTP+JSON",
      "url": "https://apparel.monster/api/v1",
      "description": "Agent Commerce API v1 \u2014 first-party REST surface for search, cart, checkout, order tracking and price watches. Anonymous except /track. SSE streaming on search and checkout. OpenAPI 3.2 at https://apparel.monster/api/v1/openapi.yaml"
    },
    {
      "transport": "HTTP+JSON",
      "url": "https://apparel.monster/api/v2/storefront",
      "description": "Spree Storefront API v2 (OpenAPI 3.0 at /api/openapi/storefront.yaml)"
    },
    {
      "transport": "JSONRPC",
      "url": "https://apparel.monster/mcp",
      "description": "Model Context Protocol endpoint (Streamable HTTP). Dual-era: serves revision 2026-07-28 statelessly and the older initialize-handshake revisions."
    },
    {
      "transport": "WebMCP",
      "url": "https://apparel.monster/webmcp.js",
      "description": "WebMCP tool bundle, auto-injected into storefront pages. An in-browser agent gets typed tools via document.modelContext instead of scraping the DOM. Spec: https://webmachinelearning.github.io/webmcp/"
    },
    {
      "transport": "HTTP+JSON",
      "url": "https://apparel.monster/checkout_sessions",
      "description": "Agentic Commerce Protocol (ACP) checkout, version 2025-09-29. REST, money in minor units."
    },
    {
      "transport": "HTTP+JSON",
      "url": "https://apparel.monster/ucp/v1",
      "description": "Universal Commerce Protocol (UCP) checkout and catalog, version 2026-04-08."
    }
  ],
  "securitySchemes": {
    "oauth2": {
      "type": "oauth2",
      "description": "OAuth 2.0 via Spree doorkeeper for customer and admin flows",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://apparel.monster/spree_oauth/authorize",
          "tokenUrl": "https://apparel.monster/spree_oauth/token",
          "refreshUrl": "https://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": "Ask in natural language and get ranked products from this store's own catalogue, as prose and as structured data. Served over A2A message/send.",
      "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. Available over the Agent Commerce API v1 and MCP (see supportedInterfaces); A2A message/send will point you at them.",
      "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. Available over the Agent Commerce API v1 and MCP (see supportedInterfaces); A2A message/send will point you at them.",
      "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). Available over the Agent Commerce API v1 and MCP (see supportedInterfaces); A2A message/send will point you at them.",
      "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?"
      ]
    }
  ]
}