gurkerl_skill

Overview

This skill connects to the Gurkerl.at MCP API to search products, manage your cart, handle orders, browse recipes, and manage favorites and user data. It supports product detail lookups, recipe-to-product mapping, order reordering and timeslot changes, and customer care operations. The same MCP approach can be adapted to other Rohlik Group brands by changing the MCP URL. It is designed for automating grocery workflows and integrating Gurkerl features into automations or chatbots.

How this skill works

The skill authenticates with Gurkerl MCP using user credentials and exposes endpoints for searching products, fetching product composition, and browsing categories. Cart tools let you add, update, remove, and clear items; order tools provide history, repeat, cancel, and timeslot management. Recipe tools support semantic search, detailed recipe views with product matches, and AI-generated recipes mapped to store inventory.

When to use it

• Automate weekly grocery shopping and maintain reusable shopping lists
• Search Austrian Gurkerl catalog using German keywords and filters
• Programmatically add matched recipe ingredients to the cart
• Reorder past purchases or modify upcoming delivery timeslots
• Integrate Gurkerl product and recipe data into a chatbot or personal assistant

Best practices

• Use German keywords for better product search relevance (e.g., "Milch", "Brot", "Eier")
• Include nutrition and allergen flags when you need dietary information
• Use filters (news, sales) and sort options (orderPriceAsc/Desc, recommended) to narrow results
• Fetch product details in batches to reduce API calls when adding many items
• For canceling orders follow the two-step confirm flow to ensure cancellation is accepted

Example use cases

• Weekly shopping automation: search sale items, add quantities, and review cart prior to checkout
• Recipe-driven shopping: find a recipe, map ingredients to store products, then add matched items to cart
• Quick reorder: fetch most recent order and call repeat_order to recreate it
• Customer support workflow: submit claims for missing or damaged items and fetch support contact info
• Delivery management: list available timeslots and change an upcoming order's timeslot