MCP-Server

offerhopper.ai — AI Supermarket & Drugstore Shopping Assistant for Germany

ai.offerhopper.mcp/german-grocery-assistant
Commerce & Retail Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Provides live German grocery and drugstore prices, deals, and multi-stop shopping route optimization.

plan_optimal_shopping_route
Plan optimal grocery and drug store shopping trip
Plans the optimal shopping trip for a given list and starting location in Germany. Answers 'where should I go to buy this list, and is the trip worth it?' — not 'what's on offer near me'. Matches each item on the list to the best current offer across German supermarkets and drug stores (REWE, Aldi, Lidl, Penny, Netto, Norma, Edeka, DM, Rossmann, Mueller, Globus), then computes the cheapest realistic route by weighing product prices against travel distance and shopping time. Returns the chosen store(s), the per-item picks with live prices, the trip's savings and a worth-it Supports car, bicycle, and pedestrian travel modes. For corridor trips (A-to-B), supply 'end_location' to route stores along the way. Pricing note: 'price' is the standard shelf price available to all shoppers (do NOT say discounts require an app). 'app_credit' is optional wallet cashback (e.g. REWE Bonus: plus €0.50 into wallet). 'app_price' is an app-exclusive checkout price (e.g. Lidl Plus).
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['items', 'location'], 'properties': {'items': {'type': 'string', 'description': "The shopping list in natural language (e.g. '3x milk, eggs, bread')"}, 'km_cost': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'default': None, 'description': 'Travel cost penalty per kilometer (forced to 0.0 for bicycle/pedestrian)'}, 'location': {'type': 'string', 'description': 'Starting location (ZIP code, city, or address in Germany)'}, 'hour_cost': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'default': None, 'description': 'Time cost penalty in EUR per hour (defaults to 12.0)'}, 'max_stores': {'type': 'integer', 'default': 100, 'description': 'Maximum number of candidate stores to evaluate for the route (default: 100)'}, 'travel_mode': {'enum': ['car', 'bicycle', 'pedestrian'], 'type': 'string', 'default': 'car', 'description': 'Travel mode to use'}, 'end_location': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional destination location if not a round trip'}, 'max_radius_km': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'default': None, 'description': 'Maximum search radius in kilometers (defaults: car=15km, bicycle=5km, pedestrian=2km)'}, 'shopping_time_per_store': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Base shopping minutes spent per store (defaults to 10)'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
swap_route_item
Swap an item on a shopping route
Swaps one item's chosen offer on an existing shopping route (from a prior plan_optimal_shopping_route result) for one of its alternatives, then returns the RECOMPUTED route with corrected costs and the honest worth-it verdict. Use this to correct a poor pick (e.g. the engine matched a soup hen instead of a roasting chicken) or to take a cheaper/better option the agent spotted in the item's 'alternatives'. The alternative may be at the SAME store or at ANOTHER store ALREADY ON THE ROUTE — it must be the same item category, and its store must already be a stop (no new stores; for that, call plan_optimal_shopping_route again). Keys on stable offer ids: pass the current item's offer_id and the target alternative's offer_id (both taken verbatim from the prior response's products_to_buy / alternatives). The shared route (share_url) is updated in place so the interactive map reflects the swap.
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['share', 'offer_id', 'alt_id'], 'properties': {'share': {'type': 'string', 'description': 'The share_url (or its 8-char id) returned by plan_optimal_shopping_route'}, 'alt_id': {'type': 'string', 'description': "offer_id of the alternative to swap in (from that item's 'alternatives')"}, 'offer_id': {'type': 'string', 'description': 'offer_id of the item currently on the route (from products_to_buy)'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
Geändert
plan_optimal_shopping_route
27. September 2026 02:51
Hinzugefügt
swap_route_item
17. September 2026 07:57
Hinzugefügt
plan_optimal_shopping_route
17. September 2026 07:57