{
  "$comment": "There is no finalized official .well-known/mcp standard yet; this file follows the emerging community convention for MCP server discovery (analogous to /.well-known/ai-plugin.json). Fields may change as the convention settles. Tool list mirrors the live server card at https://api.openshopgraph.org/.well-known/mcp.json — keep both in sync when tools change.",
  "schema_version": "2025-03-26",
  "name": "openshopgraph",
  "name_for_human": "OpenShopGraph",
  "description": "Structured, source-cited data about online shops — identity, trust tier, coupons and price/offer aggregates — with provenance (source URL + retrieval date + confidence) on every field. Content under CC-BY-4.0.",
  "server": {
    "transport": "streamable-http",
    "url": "https://api.openshopgraph.org/mcp",
    "stdio": {
      "command": "npx",
      "args": ["-y", "@openshopgraph/mcp-server"]
    }
  },
  "auth": {
    "type": "consumer_key",
    "description": "Streamable-HTTP requests require a consumer key issued by the operator. Request one via the contact address below; there is no self-service signup.",
    "contact": "contact@openshopgraph.org"
  },
  "tools": [
    {
      "name": "find_product",
      "description": "Search the canonical product catalog by free-text query; returns matching products (id, name, gtin)."
    },
    {
      "name": "get_product",
      "description": "Fetch a single canonical product by its id (from find_product)."
    },
    {
      "name": "find_offers",
      "description": "List merchant offers for a product and/or a shop."
    },
    {
      "name": "list_coupons",
      "description": "List currently visible discount codes/coupons, optionally filtered by shop domain."
    },
    {
      "name": "get_trust",
      "description": "Get the aggregated trust signal (rating, review count, source) for a shop."
    },
    {
      "name": "list_shipping_options",
      "description": "List a shop's shipping options (carrier, cost, stated delivery time)."
    },
    {
      "name": "compare_offers",
      "description": "Compare a specific set of known offer ids side by side, sorted by price ascending."
    },
    {
      "name": "compare_prices",
      "description": "The headline price-comparison query: all merchants for a product ranked by total cost (price + shipping - best coupon)."
    },
    {
      "name": "price_analytics",
      "description": "Price-drop detection and lowest-price-ever tracking for a single offer id."
    },
    {
      "name": "find_shop",
      "description": "Search merchants/shops by free-text query, optionally filtered by country."
    },
    {
      "name": "get_shop",
      "description": "Fetch a single merchant/shop by id or domain, including its current offers."
    },
    {
      "name": "report_code",
      "description": "Record that a shop domain + coupon code pair was tried and its outcome (write-only, no PII)."
    }
  ],
  "documentation_url": "https://openshopgraph.org/en/developers/mcp",
  "license": "CC-BY-4.0",
  "contact": "contact@openshopgraph.org"
}