Manual setup

\n\nAdd the following to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the equivalent on your platform:\n\n```json\n{\n \"mcpServers\": {\n \"idealo\": {\n \"type\": \"url\",\n \"url\": \"https://mcp.idealo.com/mcp\"\n }\n }\n}\n```\n\nRestart Claude Desktop and confirm the `idealo` server is listed under MCP tools.\n\n

\n\n### Claude Code\n\nRun the following command in your terminal:\n\n```bash\nclaude mcp add --transport http idealo https://mcp.idealo.com/mcp --callback-port 6274\n```\n\n

Manual setup

\n\nAdd to `.mcp.json` at the project root (Claude Code reads it automatically):\n\n```json\n{\n \"mcpServers\": {\n \"idealo\": {\n \"type\": \"url\",\n \"url\": \"https://mcp.idealo.com/mcp\",\n \"oauth\": {\n \"callbackPort\": 6274\n }\n }\n }\n}\n```\n\nUseful commands:\n\n- `claude mcp list` — list configured servers\n- `claude mcp get idealo` — show server details\n- `claude mcp remove idealo` — remove the server\n\n

\n\n### VS Code\n\n1. Use the shortcut `⌘ Shift P` to search for `MCP: Add Server`.\n2. Select `HTTP`.\n3. Paste `https://mcp.idealo.com/mcp` and hit `Enter`.\n4. When prompted for a server ID, enter `idealo`.\n5. Choose **global** or **workspace** scope.\n\nThe resulting `mcp.json` will look like:\n\n```json\n{\n \"servers\": {\n \"idealo\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.idealo.com/mcp\"\n }\n }\n}\n```\n\nOpen the chat toolbar, switch to **Agent** mode, and type `#search_products` to confirm the tools are available. If nothing shows up, restart VS Code.\n\n> [!NOTE]\n> You must have [GitHub Copilot](https://github.com/features/copilot) enabled to use MCP in VS Code.\n\n### Cursor\n\n

Manual setup

\n\n1. Open **Cursor → Settings → Cursor Settings**.\n2. Go to the **MCP** tab.\n3. Click **+ Add new global MCP server**.\n4. Enter and save:\n\n```json\n{\n \"mcpServers\": {\n \"idealo\": {\n \"url\": \"https://mcp.idealo.com/mcp\"\n }\n }\n}\n```\n\n

\n\n### Other editors\n\nAny client that supports the **Streamable HTTP** transport can connect. Use:\n\n```json\n{\n \"mcpServers\": {\n \"idealo\": {\n \"url\": \"https://mcp.idealo.com/mcp\"\n }\n }\n}\n```\n\n## Authentication\n\nThe server uses OAuth 2.0 with **Dynamic Client Registration (DCR) + PKCE**. Spec-compliant MCP clients discover the auth flow automatically through `.well-known/oauth-protected-resource` — no `client_id` / `client_secret` setup required for the Trial tier. On first connect, your client opens a browser for login. Tokens are cached client-side and refreshed transparently.\n\nPartner-tier credentials are issued separately by idealo upon request.\n\n## Prompting your MCP client\n\nOnce connected, prompt your client in plain language. The 4 tools chain together via an opaque `productRef` returned by `search_products`.\n\nExamples:\n\n- *\"Find running shoes under €100 available in Germany.\"*\n- *\"Show me details, top offers, and pros/cons for the cheapest result.\"*\n- *\"Walk through every offer until I see one that ships free with PayPal accepted.\"*\n- *\"Give me the 30-day price history and tell me whether now is a good time to buy.\"*\n\n## Tips & Best Practices\n\n- **Use `productRef`.** `search_products` returns an encrypted `productRef` per result — pass that string directly to `get_product_details`, `get_product_offers`, and `get_product_price_history`. It's opaque, marketplace-aware, and short-lived.\n- **`includeSearchFilters` and `includeSizeFilters` require `includeCategories`.** The server rejects calls that send attribute or size filters without at least one numeric category ID. Search first without filters to discover available `categoryId`s in the response.\n- **Pick the right country.** Pass `country` as a 2-letter ISO code (`DE`, `AT`, `GB`, `FR`, `IT`, `ES`). Unknown codes silently fall back to Germany.\n- **Paginate offers properly.** `get_product_offers` returns 5 offers per call plus a `nextOffset`. Loop until `nextOffset === 0`.\n- **Some shops are filtered out.** Compliance blocklist removes Amazon, eBay, and Otto offers from all tiers — this is intentional and applies regardless of tier.\n- **Hit the same marketplace consistently.** A `productRef` from `country=DE` won't return useful data when reused with `country=GB`.\n\n## Supported markets\n\n🇩🇪 Germany · 🇬🇧 United Kingdom · 🇫🇷 France · 🇮🇹 Italy · 🇪🇸 Spain · 🇦🇹 Austria\n\n## Support\n\n- Website: [idealo.de](https://www.idealo.de)\n- Tool reference: [docs/tools.md](https://github.com/idealo/mcp-server-guide/blob/main/docs/tools.md)\n- Partner-tier requests: mcp@idealo.de\n- Request support for a new MCP client: mcp@idealo.de\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_100":101,"_102":103,"_104":-5,"_105":106,"_107":108,"_109":110},"requiredSecrets",[],"tags",[98,19,99],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","claude","price-comparison","topics",[98,19,111,112,99],"license","MIT","language","registryName","com.idealo.mcp/mcp","homepage","https://mcp.idealo.com/mcp","packages",[],"mcp","model-context-protocol","ENV",{"_115":116,"_117":118,"_119":120},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

idealo MCP Server