idealo MCP Server Guide

The idealo MCP server brings idealo’s product intelligence directly into your AI assistant — search products, compare prices across hundreds of shops, and analyse 30-day price history across 6 European marketplaces (DE, AT, GB, FR, IT, ES) without ever leaving your editor.

[!NOTE] Rate limits apply to all idealo MCP server tools.

The default Trial tier is self-serve via OAuth and gives you 3 req/s · 6 burst · 500 calls/day per user. Trial responses include a single product image, cap get_product_offers at 10 offers per product, and exclude shop logos, external links, and detailed user reviews.

Partner tier unlocks higher rate limits, full image arrays, shop logos, test-report links, and full user-review payloads. To request Partner access, contact us via [email protected].

For the complete tool reference (input schemas, sample responses, tier-by-tier field differences), see docs/tools.md.

Features

• Catalog search — Full-text search with filters for category, brand, price range, availability, and bargains across 6 European marketplaces. Returns an encrypted productRef you pass to the other tools.

• Product details — Fetch a complete product profile: top offers, reviews summary, expert review, test reports, technical specifications, pros/cons, and a 30-day price trend in a single call.

• Paginated offers — Walk every offer for a product with shop name, ratings, pricing breakdown, delivery estimates, payment methods, free-return policy, and shipping costs. 5 offers per page.

• Price history & analytics — 30-day price trend with min/max/avg statistics, percentage change, sampling granularity, ASCII chart, and AI-generated buying recommendations.

Installation & Setup

Different MCP clients require slightly different setups. Follow the instructions below for your specific client.

Claude Desktop

The recommended way is via Custom Connectors:

1. Open Claude → Settings → Connectors.
2. Click Add custom connector.
3. Enter the URL https://mcp.idealo.com/mcp and click Add.
4. Authenticate when prompted — Claude opens a browser for the OAuth handshake.

Claude Code

Run the following command in your terminal:

claude mcp add --transport http idealo https://mcp.idealo.com/mcp --callback-port 6274

Add to .mcp.json at the project root (Claude Code reads it automatically):

{
  "mcpServers": {
    "idealo": {
      "type": "url",