Agentic Shelf — Live Catalog Agent

{
  "protocolVersion": "0.3.0",
  "name": "Agentic Shelf \u2014 Live Catalog Agent",
  "description": "Read-only product catalog, inventory, and pricing for multi-tenant e-commerce stores, exposed as agent tools over the Model Context Protocol (streamable-http). Each merchant connects their store; AI agents query the live catalog via a per-tenant MCP URL (/m/{slug}/mcp). This card describes the shared capability shape; see the per-tenant card at /m/{slug}/.well-known/agent.json for a specific store.",
  "version": "0.1.0",
  "url": "https://api.agenticshelf.ai/mcp",
  "preferredTransport": "streamable-http",
  "provider": {
    "organization": "Agentic Shelf",
    "url": "https://www.agenticshelf.ai"
  },
  "homepageUrl": "https://www.agenticshelf.ai",
  "documentationUrl": "https://www.agenticshelf.ai/console",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "securitySchemes": {
    "publicTenantUrl": {
      "type": "apiKey",
      "in": "path",
      "name": "slug",
      "description": "The tenant slug in the MCP URL path (/m/{slug}/mcp) selects the merchant. No token required for read-only catalog access."
    },
    "firebaseBearer": {
      "type": "http",
      "scheme": "bearer",
      "bearerFormat": "Firebase ID token",
      "description": "Optional Bearer token for the canonical /mcp endpoint; issued via the merchant console after Google sign-in + store connect."
    }
  },
  "security": [
    {
      "publicTenantUrl": []
    },
    {
      "firebaseBearer": []
    }
  ],
  "skills": [
    {
      "id": "list-products",
      "name": "List products",
      "description": "Browse the catalog, paginated. Returns SKU, title, a short description, price, currency, availability, and storefront URL for each product. Use this to DISCOVER products when no SKU is known yet; follow up with get-product-details or check-stock.",
      "tags": [
        "catalog",
        "discovery",
        "browse",
        "read-only"
      ],
      "examples": [
        "List the available products.",
        "Show the first 10 products in the catalog."
      ]
    },
    {
      "id": "search-products",
      "name": "Search products",
      "description": "Keyword search over product titles and tags (storefront-native search semantics \u2014 keywords, not full natural-language sentences). Returns the same shape as list-products.",
      "tags": [
        "catalog",
        "search",
        "read-only"
      ],
      "examples": [
        "Search products for 'decaf'.",
        "Find products tagged 'gift'."
      ]
    },
    {
      "id": "get-product-details",
      "name": "Get product details",
      "description": "Full catalog record for one SKU: title, description, product type, tags, price, inventory quantity, availability, image. Use when the shopper wants depth on a specific product.",
      "tags": [
        "catalog",
        "product",
        "read-only"
      ],
      "examples": [
        "Get full details for a specific SKU."
      ]
    },
    {
      "id": "check-stock",
      "name": "Check stock",
      "description": "Real-time availability for a SKU: in-stock status, price in USD, and a can_ship_today flag. The tool to answer 'is it in stock' / 'can it ship today'.",
      "tags": [
        "inventory",
        "availability",
        "read-only"
      ],
      "examples": [
        "Is a given SKU in stock right now?"
      ]
    },
    {
      "id": "get-price",
      "name": "Get price",
      "description": "Current price in USD for a SKU (price and currency only \u2014 not shipping or promotional math).",
      "tags": [
        "pricing",
        "read-only"
      ],
      "examples": [
        "What's the current price of a SKU?"
      ]
    }
  ],
  "mcp": {
    "endpoint": "https://api.agenticshelf.ai/mcp",
    "transport": "streamable-http",
    "tools": [
      "list_products",
      "search_products",
      "get_product_details",
      "check_stock",
      "get_price"
    ]
  },
  "tags": [
    "e-commerce",
    "catalog",
    "inventory",
    "shopping",
    "agent",
    "read-only"
  ]
}