{
  "$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.com/.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.com/mcp",
    "stdio": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.openshopgraph.com/mcp"],
      "note": "No first-party npm package is published for this server; this uses the community mcp-remote bridge to reach the streamable-http transport above."
    }
  },
  "auth": {
    "type": "consumer_key",
    "description": "Most tools work without a key — see each tool's \"auth\" field below (\"none\" or \"api_token\"). Only get_trust, report_code and report_issue require a consumer key via the x-api-token header. Request one via the contact address below; there is no self-service signup.",
    "contact": "info@openshopgraph.com"
  },
  "tools": [
    {
      "name": "find_shop",
      "description": "Search merchants/shops by free-text query, optionally filtered by country.",
      "auth": "none"
    },
    {
      "name": "list_categories",
      "description": "Enumerate the shop category taxonomy; call this before passing a category to find_shop.",
      "auth": "none"
    },
    {
      "name": "get_shop",
      "description": "Fetch a single merchant/shop by id or domain, including its current offers.",
      "auth": "none"
    },
    {
      "name": "list_coupons",
      "description": "List currently visible discount codes/coupons, optionally filtered by shop domain.",
      "auth": "none"
    },
    {
      "name": "get_shipping_policy",
      "description": "Fetch what a shop states about its own shipping — destinations, delivery estimate and free-shipping threshold — with the date last checked; not a live carrier quote.",
      "auth": "none"
    },
    {
      "name": "get_trust",
      "description": "Trust-relevant facts OpenShopGraph measured itself — TLS certificate issuer and grade, hosting ISP and country, domain registration date, registrar, accepted payment methods. Returns INDIVIDUAL signals, each with its own source and check date; deliberately no score, rating or star value. Nothing measured means status \"no_signals_collected\" with an empty list — that is not a zero and not a negative verdict.",
      "auth": "api_token"
    },
    {
      "name": "report_code",
      "description": "Record that a shop domain + coupon code pair was tried and its outcome (write-only, no PII).",
      "auth": "api_token"
    },
    {
      "name": "report_issue",
      "description": "Record a shop-level or data-fact issue as one fixed, documented reason (write-only) — never changes delivered data directly, only queues a re-check.",
      "auth": "api_token"
    }
  ],
  "policy": {
    "paid_placement": false,
    "ranking_criteria": ["data_quality", "verification"],
    "affiliate_in_ranking": false,
    "outbound_links": "canonical_naked",
    "data_license": "CC-BY-4.0"
  },
  "documentation_url": "https://openshopgraph.com/en/developers/mcp",
  "license": "CC-BY-4.0",
  "contact": "info@openshopgraph.com"
}