mediamarkt-mcp

MCP server that exposes MediaMarkt NL's "AI-modus" shopping assistant as one tool, ask_mediamarkt.

ChatGPT calling ask_mediamarkt with MEDIAMARKT_UI=widget: the MCP Apps carousel shows the products, the model uses the text answer.

How it works

The MediaMarkt site's chat widget POSTs to https://www.mediamarkt.nl/api/v1/ai-chat (Vercel AI SDK UI-message format, SSE response). No login or cookies are needed, only x-mms-country/-language/-salesline headers and a browser User-Agent. The assistant runs its own tools (search, compare, availability, stores) and streams back MCP-style tool results; this server collects the text answer plus the structured product list (with images).

Unofficial endpoint: it can change or be blocked at any time. See MediaMarkt's AI chatbot terms.

Related MCP server: Periskop MCP Server

Install

npm install
npm run check   # live smoke test against mediamarkt.nl

Run

Streamable HTTP is the default (stateless, works for ChatGPT, Codex, Claude):

node index.mjs                       # http://localhost:3000
PORT=8080 node index.mjs
MEDIAMARKT_UI=widget node index.mjs  # also serve the product carousel UI (MCP Apps)
node index.mjs --stdio               # stdio transport instead

Settings (environment):

Connect

codex mcp add mediamarkt --url http://localhost:3000

For ChatGPT, expose the HTTP server publicly (e.g. cloudflared tunnel --url http://localhost:3000) and add the URL under Settings → Apps in developer mode. Run with MEDIAMARKT_UI=widget to get the carousel.

Widget mode is opt-in for new users: set MEDIAMARKT_MCP_WIDGET_DOMAIN to the widget host's HTTPS origin. The local LaunchAgent derives both its public MCP URL and widget origin from the machine's current Tailscale hostname while keeping MEDIAMARKT_UI=widget enabled locally.

Tool

ask_mediamarkt({ question, language? }) — language is en (default) or nl; the answer follows the question's language, en also switches product names and URLs to the English storefront. Returns content[0].text (the assistant's answer plus product names, prices and sellers) and structuredContent.products[] (productId, ean, name, brand, price, currency, seller, deliveryTime, url, image).