For AI agents

Your AI assistant can query this directly.

Assistants read verified, structured shop data instead of guessing from SEO pages — via the MCP server or the JSON-LD embedded in every record page.

Request — via MCP (example shape)

shops.search({
query: "wireless headphones",
ship_to: "PT",
verified_only: true
})

Response — verified & timestamped (example shape)

{
"shop": "example-shop.com",
"trust": { "imprint": "verified 2026-06-30" },
"codes": [{ "code": "EXAMPLE15",
"last_verified": "2026-06-30" }] }

Try it from your own assistant: ChatGPT Claude Perplexity Grok Mistral Asia/China AIs:

Logos indicate compatibility, not endorsement.

Full MCP documentation Discovery: /llms.txt · /.well-known/ai.txt · /.well-known/mcp.json · JSON-LD on every record

Install it

Paste this into your MCP client config and restart. There is no one-click install link we can verify works everywhere today — this copy-paste config is the honest, tested path.

Claude Desktop / Cursor (mcpServers block)

{
  "mcpServers": {
    "openshopgraph": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.openshopgraph.org/mcp"]
    }
  }
}

Generic MCP client (streamable-HTTP)

MCP endpoint (streamable-HTTP): https://api.openshopgraph.org/mcp
Server card (schema): https://openshopgraph.com/.well-known/mcp.json
Auth: find_shop, list_categories, get_shop, list_coupons and
  get_shipping_policy need no key. get_trust, report_code and
  report_issue need an "x-api-token" header (request one:
  info@openshopgraph.com, no self-service signup yet).

Try these prompts

Once installed, ask your assistant things like:

“Use OpenShopGraph's compare_prices to find the cheapest place to buy an iPhone 16 Pro 256GB shipping to Germany.”
“Look up bergzeit.de on OpenShopGraph — what's its trust rating, and are there active coupons?”
“Compare shipping options and delivery times for bergzeit.de on OpenShopGraph.”
“Find shops on OpenShopGraph that ship to Portugal and sell wireless headphones, then compare prices.”

What the MCP server can do

All 8 tools, in one place — full schema at /.well-known/mcp.json or the integration guide.

find_shop: Search merchants by free text, optionally filtered by country.
list_categories: Enumerate the shop category taxonomy — call this before passing a category to find_shop.
get_shop: Fetch one merchant by id or domain, including its current offers.
list_coupons: List currently visible discount codes, optionally by shop.
get_shipping_policy: A shop's stated shipping terms (destinations, delivery estimate, free threshold), with last-checked date.
get_trust: Trust-relevant facts OpenShopGraph measured itself (TLS, hosting, domain age, registrar, payment methods) — individual signals with source and check date, deliberately no score.
report_code: Report whether a coupon code worked (write-only, no PII).
report_issue: Report a shop-level or data-fact issue as one fixed, documented reason (write-only, no free text) — queues a re-check, never changes delivered data directly.

All tools are read-only except report_code, which only appends an outcome (no PII) and does not immediately change what other tools return.