Skip to main content
Glama
Sign In
MediaMarkt & Saturn MCP

MediaMarkt & Saturn MCP

by washedguy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

MediaMarkt & Saturn MCP

MCP server for MediaMarkt, MediaWorld, and Saturn products, prices, and availability.

Quick start

Install uv and add this to your MCP client configuration:

{
  "mcpServers": {
    "mediamarkt-saturn": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/washedguy/mediamarkt-saturn-mcp",
        "mediamarkt-saturn-mcp"
      ]
    }
  }
}

Related MCP server: Czech DIY Retail MCP Server

Tools

Tool

What it does

list_storefronts

List supported countries, shop languages, currencies, and delivery filters.

search_products

Search by keyword, brand, price, and home delivery. Set include_offers: true to also fetch linked variants and marketplace offers.

browse_page

Explore shop brand, category, offer and campaign pages, including related_pages from a brand hub.

get_product

Get product details, variants, and marketplace offers by ID or URL.

find_stores

Find stores by city, postal code, or name.

check_pickup_availability

Check product IDs at a selected store.

Choose mediamarkt or saturn as retailer and set country and, optionally, language. Defaults are mediamarkt, de, and the country's default language. Use the same retailer and country for products and stores; IDs are country-specific. Italy uses MediaWorld under retailer: mediamarkt.

Country

country

Shop languages

Germany

de

de (MediaMarkt and Saturn)

Austria

at

de

Switzerland

ch

de, fr, it

Netherlands

nl

nl

Belgium

be

nl, fr

Spain

es

es

Italy

it

it

Poland

pl

pl

Hungary

hu

hu

Türkiye

tr

tr

Prices use the storefront's local currency. delivery_only uses the shop's in-stock delivery filter and is not yet available for Spain, Italy, or Türkiye. For example:

Find Nintendo Switch consoles at Saturn under €500, then check pickup at a store in Berlin.

Notes

  • Set HTTPS_PROXY (or ALL_PROXY and NO_PROXY) to configure a proxy.

  • Search results and marketplace offers may be incomplete. include_offers loads product pages and can take longer.

  • Pickup availability is an estimate, not a reservation or exact stock count. Set fresh: true to bypass the local cache.

  • This is an unofficial integration and storefront behavior may change.

Development

To work on the server locally (Python 3.11+):

git clone https://github.com/washedguy/mediamarkt-saturn-mcp.git
cd mediamarkt-saturn-mcp
uv sync --frozen
uv run mediamarkt-saturn-mcp --config

Run uv run python -m unittest discover -s tests -v for tests and uv run ruff check mediamarkt_mcp tests for linting.

Author

washed.dev · Building websites and web apps for your business

License

MIT

Available Tools

5 tools
check_pickup_availabilityA

Check pickup availability for products at one selected store. Use IDs from search_products and find_stores for the same retailer and country. Unknown means the retailer returned no status; a status for an unverified ID does not confirm the product exists. Availability is not a reservation or exact stock count.

Inputs: store_id (required), product_ids (required), fresh, country, +2 more. Returns: cache, count, country, language, +5 more

find_storesA

Find stores in the selected country and language by location. Choose the intended store ID before checking pickup; do not assume the first result is the right one.

Inputs: query (required), fresh, country, language, +1 more. Returns: cache, count, query, stores, +4 more

get_productA

Read product details from the product page by exact ID or product URL, including description, EAN, images, rating, variants, linked marketplace offers and specifications where available. Offers are limited to what the page embeds and are not necessarily complete. Returns found=false for a 404 URL or if the requested ID is absent from a redirected product page; this does not prove the product no longer exists.

Inputs: reference (required), fresh, country, language, +1 more. Returns: cache, found, reason, country, +5 more

list_storefrontsA

List supported countries, retailers, shop languages, currencies and in-stock delivery-filter availability. Product and store IDs are country-specific. Italian MediaMarkt is called MediaWorld; Saturn is Germany only.

Inputs: no named parameters. Returns: storefronts

search_productsA

Search the selected MediaMarkt, MediaWorld or Saturn storefront for product names, prices and home delivery. Search can return suggestions unrelated to the query; verify relevance. Redirected landing pages return only visible products with available data, may include unrelated products, and support local brand/price filters on visible products only, but not delivery filters or pagination. Set include_offers to inspect linked variants and embedded marketplace offers for each result; slower and not exhaustive. Use get_product for exact IDs or URLs. Returns pagination for more results.

Inputs: query (required), page, brand, fresh, +7 more. Returns: note, page, cache, count, +13 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation4/5

    Each tool has a distinct role: search vs. exact product retrieval, store location vs. storefront country listing, and pickup status. Some potential overlap exists between search_products and get_product when users have URLs/IDs, but descriptions clarify the boundary.

    Naming Consistency5/5

    All tool names follow a clean snake_case verb_noun pattern: search_products, find_stores, check_pickup_availability, list_storefronts, get_product. The convention is predictable and easy to scan.

    Tool Count5/5

    Five tools is well-scoped for a retail product/store lookup server. Each tool earns its place and there is no redundant surface area.

    Completeness4/5

    The toolset covers storefront discovery, product search, product detail retrieval, store lookup, and pickup availability, which is a coherent browsing lifecycle. It lacks explicit cart/ordering or delivery estimation operations, but those may be outside the server's intended scope.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • idealo MCP Server

      idealo MCP Serverofficial

      idealo
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables product search, price comparison, and price history analysis across 6 European marketplaces (DE, AT, GB, FR, IT, ES).
      25
      MIT

    • electronic-components-mcp

      veronoicc
      A
      license
      A
      quality
      B
      maintenance
      Enables users to search parts and products across German and global retailers, inspect item details, and manage per-store shopping carts with accurate shipping, pickup options, and free-shipping thresholds.
      11
      379 npm
      MIT