Open Price Engine | MCP Documentation

Premium exclusive

Overview

The Open Price Engine MCP server exposes grocery and electronics price tools to AI agents. It proxies your Premium key to the same REST API used by /api/v1 — plan limits stay enforced server-side. Grocery shops and electronics retailers are separate catalogs; use the matching tools for each.

Endpoint

https://mcp.openpricengine.com/mcp

Transport: Streamable HTTP Auth: Authorization header Plan: Premium only

Connect your client

Add the remote server to your MCP config. No Python package or npx install.

Cursor / Claude Desktop

{
  "mcpServers": {
    "openpricengine": {
      "url": "https://mcp.openpricengine.com/mcp",
      "headers": {
        "Authorization": "YOUR_PREMIUM_API_KEY"
      }
    }
  }
}

After saving, restart the client and ask it to call list_countries or list_stores.

Authentication

Send your Premium API key on every connection:

Authorization: YOUR_PREMIUM_API_KEY

Bearer <key> and X-API-Key are also accepted. Create a key on the Premium plan page.

Free API keys cannot use MCP. A missing or Free key returns 401/403.

Recommended flow

Agents get better results when they discover first, then price. Grocery and electronics are separate catalogs:

1. List stores Grocery: list_stores · Electronics: list_electronics_stores

2. Search names Grocery: search_products · Electronics: search_electronics_products

3. Fetch prices Grocery: get_product_price · Electronics: get_electronics_price

4. Compare Grocery: compare_prices · Electronics: compare_electronics_prices

Tools

Twenty tools are available. Grocery and electronics each have their own discovery and price tools. Responses are compacted for LLM context.

Grocery discovery

Tool	What it does	Key params
TOOL `list_countries`	Countries with grocery coverage	—
TOOL `list_stores`	Tracked stores by country	`country` (one or many)
TOOL `get_plan_access`	Plan store access (MCP = Premium)	—
TOOL `list_currencies`	Supported currencies	—
TOOL `search_products`	Search product names across shops/countries	`query`, `stores`, `countries`

Grocery prices

Tool	What it does	Key params
TOOL `get_product_price`	Latest price at one store	`store`, `product`
TOOL `price_history`	Historical series	`start_date`, `end_date`
TOOL `compare_prices`	Compare across retailers and countries	`product`, `stores`, `countries`
TOOL `find_cheapest_store`	Cheapest basket total	`products`, `stores`, `countries`
TOOL `market_statistics`	Min / max / avg / % change	date range

Electronics

Electronics retailers are a separate catalog from grocery shops. Start with list_electronics_stores, then search and fetch prices. Pass one or more countries to query across markets. Use a shared currency such as USD when comparing prices internationally.

Tool	What it does	Key params
TOOL `list_electronics_stores`	Electronics retailers by country	`country` (one or many)
TOOL `search_electronics_products`	Search product names across electronics shops	`query`, `stores`, `countries`
TOOL `get_electronics_price`	Latest price at one electronics retailer	`store`, `product`, `currency`
TOOL `electronics_price_history`	Historical electronics series	`start_date`, `end_date`
TOOL `compare_electronics_prices`	Compare across electronics retailers and countries	`product`, `stores`, `countries`

Example: list_electronics_stores("South Africa") then compare_electronics_prices(product="galaxy s25", countries="South Africa,United Kingdom", currency="USD").

Fuel & watches

Tool	What it does	Key params
TOOL `fuel_prices`	Fuel / electricity / gas by country	`countries`, `month`
TOOL `track_price`	Create a watch (scoped to your key)	`store`, `product`, `target_price`
TOOL `check_price_watches`	Poll watches for target hits	—
TOOL `list_price_watches`	List your watches	—
TOOL `remove_price_watch`	Delete a watch	`watch_id`

Watches are stored on the MCP server per API key. Email/push alerts are not available yet — use check_price_watches to poll.

Errors

Code	Meaning	What to do
`401`	Missing Authorization header	Add your Premium key to the MCP client headers
`403`	Non-Premium, expired, or plan limit	Upgrade at Premium plan
`404`	Store / product / date not found	Use `list_stores` / `list_electronics_stores` and the matching search tool

FAQ

Do I install anything locally?

No. Use the hosted URL https://mcp.openpricengine.com/mcp with a Premium key.

Can I query electronics prices?

Yes. Use list_electronics_stores, search_electronics_products, get_electronics_price, electronics_price_history, and compare_electronics_prices. Do not pass grocery shop names to electronics tools.

Does MCP bypass plan limits?

No. Every tool call hits the REST API with your key; limits still apply.

How do I verify the server is up?

GET https://mcp.openpricengine.com/health should return {"status":"ok"}.

Need help?

Email support@openpricengine.com or read the REST documentation.

MCP documentation