idealo MCP Server

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 getproductoffers 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 mcp@idealo.de.

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.

Manual setup

Add the following to ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or the equivalent on your platform:

{
  "mcpServers": {
    "idealo": {
      "type": "url",
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

Restart Claude Desktop and confirm the idealo server is listed under MCP tools.

Claude Code

Run the following command in your terminal:

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

Manual setup

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

{
  "mcpServers": {
    "idealo": {
      "type": "url",
      "url": "https://mcp.idealo.com/mcp",
      "oauth": {
        "callbackPort": 6274
      }
    }
  }
}

Useful commands:

• claude mcp list — list configured servers
• claude mcp get idealo — show server details
• claude mcp remove idealo — remove the server

VS Code

1. Use the shortcut ⌘ Shift P to search for MCP: Add Server.
2. Select HTTP.
3. Paste https://mcp.idealo.com/mcp and hit Enter.
4. When prompted for a server ID, enter idealo.
5. Choose global or workspace scope.

The resulting mcp.json will look like:

{
  "servers": {
    "idealo": {
      "type": "http",
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

Open the chat toolbar, switch to Agent mode, and type #search_products to confirm the tools are available. If nothing shows up, restart VS Code.

[!NOTE]

You must have GitHub Copilot enabled to use MCP in VS Code.

Cursor

Manual setup

Shortened. The full README is on GitHub.