openpricengine · MCP

MCP documentation

Connect Cursor, Claude Desktop, and other AI clients to Open Price Engine over remote HTTP. Premium API key required — no local install.

Connect Get Premium key Health check

Premium exclusive

Overview

The Open Price Engine MCP server exposes 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.

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:

1. List stores list_stores / list_countries

2. Search names search_products for exact titles

3. Fetch prices get_product_price or price_history

4. Compare compare_prices / find_cheapest_store

Tools

Fifteen tools are available. Responses are compacted for LLM context.

Discovery

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

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	`stores`, `product`
TOOL `find_cheapest_store`	Cheapest basket total	`stores`, `products`
TOOL `market_statistics`	Min / max / avg / % change	date range

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` and `search_products`

FAQ

Do I install anything locally?

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

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.