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/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.org/.well-known/mcp.json
Auth: consumer key via "x-api-token" header (request one: contact@openshopgraph.org)

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 12 tools, in one place — full schema at /.well-known/mcp.json or the integration guide.

find_product: Search the product catalog by free text, e.g. "iphone 16 pro 256gb".
get_product: Fetch one canonical product by id.
find_offers: List merchant offers for a product and/or a shop.
list_coupons: List currently visible discount codes, optionally by shop.
get_trust: Get a shop's aggregated trust signal (rating, review count, source).
list_shipping_options: List a shop's shipping options — carrier, cost, delivery time.
compare_offers: Compare a known set of offer ids side by side, price ascending.
compare_prices: Headline tool: ranks every merchant for a product by total cost (price + shipping − best coupon).
price_analytics: Price-drop detection and lowest-price-ever tracking for one offer.
find_shop: Search merchants by free text, optionally filtered by country.
get_shop: Fetch one merchant by id or domain, including its current offers.
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.