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": ["-y", "@openshopgraph/mcp-server"]
    }
  }
}

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: consumer key via "x-api-token" header (request one: info@openshopgraph.com)

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 6 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.
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).

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