{
  "name": "BuyWhere",
  "description": "Agent-native product catalog API for AI shopping agents: 300M+ products from 238,000+ direct merchants worldwide, with location-aware deliver_to ranking and per-result availability labels.",
  "url": "https://buywhere.ai",
  "provider": {
    "organization": "BuyWhere",
    "url": "https://buywhere.ai"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": true
  },
  "authentication": {
    "schemes": ["apiKey", "oauth2"]
  },
  "defaultInputModes": ["text"],
  "defaultOutputModes": ["text", "json"],
  "skills": [
    {
      "id": "product-search",
      "name": "Product Search",
      "description": "Search 300M+ products worldwide by keyword, category, price range, merchant, country, and deliver_to for deliverable-first ranking.",
      "tags": ["e-commerce", "search", "products", "availability"],
      "examples": [
        "Find wireless earbuds under 150 USD that ship to US",
        "Find coffee makers deliverable to Singapore with local or ships_to_you availability"
      ]
    },
    {
      "id": "location-aware-shopping",
      "name": "Location-Aware Shopping",
      "description": "Use deliver_to=<ISO country> to rank products your end user can actually receive; every result includes availability: local, ships_to_you, unavailable, or unknown.",
      "tags": ["delivery", "availability", "cross-border", "ranking"],
      "examples": [
        "Show laptop deals deliverable to AU and hide unavailable results",
        "Find skincare products that ship to GB with availability labels"
      ]
    },
    {
      "id": "cross-storefront-comparison",
      "name": "Cross-Storefront Product Comparison",
      "description": "Compare products, prices, attributes, and availability across 238,000+ independent storefronts worldwide.",
      "tags": ["comparison", "price-comparison", "affiliate", "merchant"],
      "examples": [
        "Compare iPhone 16 Pro Max prices across stores that ship to Singapore",
        "Find equivalent robot vacuums across US and EU storefronts with best delivered price"
      ]
    },
    {
      "id": "deal-finder",
      "name": "Deal Finder",
      "description": "Find discounted products and price drops across the global catalog, with filters for category, currency, country, and deliverability.",
      "tags": ["deals", "discounts", "pricing"],
      "examples": [
        "Show the best monitor deals today that ship to CA",
        "Find air purifier discounts deliverable to SG under 300 SGD"
      ]
    }
  ],
  "protocols": {
    "mcp": {
      "serverUrl": "https://api.buywhere.ai/mcp",
      "transport": "streamable-http",
      "notes": "Canonical MCP endpoint for JSON-RPC over HTTP POST. The legacy SSE endpoint remains at https://api.buywhere.ai/mcp/sse for SSE clients that explicitly require it."
    },
    "a2a": {
      "serverUrl": "https://api.buywhere.ai/a2a",
      "transport": "json"
    },
    "rest": {
      "serverUrl": "https://api.buywhere.ai/v1",
      "transport": "https"
    }
  },
  "contact": {
    "email": "hello@buywhere.ai"
  }
}
