- name
- gurkerl
- description
- Gurkerl.at grocery shopping via MCP - search products, manage cart, orders, recipes, favorites.
- homepage
- https://www.gurkerl.at/seite/mcp-server
- metadata
- clawdbot
- emoji
- 🥒
- requires
- bins
- ["curl", "jq"]
- env
- tags
Gurkerl.at MCP Skill
Austrian grocery delivery service (part of Rohlik Group). Search products, manage your cart, view orders, browse recipes, and more.
Note: This skill uses Gurkerl's official MCP server. The same approach works for other Rohlik Group brands (Rohlik.cz, Knuspr.de, Kifli.hu) — just change the MCP URL in the script.
Setup
Set environment variables:
export GURKERL_EMAIL="your@email.com"
export GURKERL_PASS="your-password"
For persistent access, add to ~/.config/systemd/user/openclaw-gateway.service.d/gurkerl.conf:
[Service]
Environment="GURKERL_EMAIL=your@email.com"
Environment="GURKERL_PASS=your-password"
CLI Usage
# Search products (German keywords) — use batch_search_products with queries array
gurkerl batch_search_products '{"queries":[{"keyword":"Milch"}]}'
gurkerl batch_search_products '{"queries":[{"keyword":"Bio Eier","sort_type":"orderPriceAsc"}]}'
# Search multiple products at once (more efficient)
gurkerl batch_search_products '{"queries":[{"keyword":"Milch"},{"keyword":"Brot"},{"keyword":"Eier"}]}'
# Get cart
gurkerl get_cart
# Add to cart
gurkerl add_items_to_cart '{"items":[{"productId":1234567,"quantity":2}]}'
# View orders
gurkerl fetch_orders '{"limit":3}'
gurkerl fetch_orders '{"order_type":"upcoming"}'
# Search recipes
gurkerl search_recipes_by_vector_similarity '{"query":"vegetarisch schnell"}'
Available Tools
Products & Search
| Tool | Description |
|---|
batch_search_products | Search by keyword(s). Takes {"queries":[{"keyword":"..."}]}. Each query can include sort_type, filters. Use German keywords. |
get_products_details_batch | Get details for multiple product IDs |
get_products_composition_batch | Nutritional info, allergens, ingredients for multiple products |
Cart
| Tool | Description |
|---|
get_cart | View current cart |
add_items_to_cart | Add products: {"items":[{"productId":123,"quantity":1}]} |
update_cart_item | Change quantity: {"product_id":123,"quantity":3} |
remove_cart_item | Remove item: {"product_id":123} |
clear_cart | Empty entire cart |
Checkout
| Tool | Description |
|---|
get_checkout | View checkout state |
get_timeslots_checkout | Available delivery timeslots |
change_timeslot_checkout | Select a delivery timeslot |
change_checkout_packaging | Change packaging options |
update_payment_method_checkout | Change payment method |
submit_checkout | Submit the order |
Orders
| Tool | Description |
|---|
fetch_orders | Get order history. Params: limit, order_type (delivered/upcoming/both), date_from, date_to |
repeat_order | Reorder: {"order_id":12345678} |
cancel_order | Cancel upcoming order (two-step: first customer_confirmed:false, then true) |
get_alternative_timeslots | Get available delivery times for existing order |
change_order_timeslot | Change delivery slot for existing order |
remove_order_items | Remove items from an upcoming order |
Recipes
| Tool | Description |
|---|
search_recipes_by_vector_similarity | Semantic recipe search |
get_recipe_detail | Full recipe with ingredients mapped to products |
generate_recipe_with_ingredients_search | AI-generated recipes with product matches |
User & Favorites
| Tool | Description |
|---|
get_user_info | Account profile |
get_user_credits | Available credits/vouchers |
get_all_user_favorites | All favorited products |
get_user_shopping_lists_preview | List all shopping lists |
get_user_shopping_list_detail | View list contents |
create_shopping_list | Create new list |
add_products_to_shopping_list | Add products to a list |
remove_products_from_shopping_list | Remove products from a list |
delete_shopping_list | Delete a shopping list |
Customer Care
| Tool | Description |
|---|
submit_claim | File warranty claim for missing/damaged items |
submit_credit_compensation | Request credit compensation |
get_customer_support_contact_info | Phone, email, WhatsApp |
get_user_reusable_bags_info | Check bag deposit status |
adjust_user_reusable_bags | Correct bag count |
credit_customer_returnables | Credit returnable deposits |
get_customer_care_workflow_prompt | Internal workflow guidance |
Analytics & Other
| Tool | Description |
|---|
calculate_average_user_order | Generate typical order from history |
analyze_spending | Spending analysis and insights |
add_feedback | Submit product/service feedback |
add_karma_rating | Rate delivery/service |
get_faq_content | FAQ for: general, xtra_general, xtra_price, baby_club, christmas |
get_url_content | Fetch content from a URL |
email_support_on_user_behalf | Send support email |
fetch_all_job_listings | Career opportunities |
Search Tips
- Use German keywords for Austrian Gurkerl: "Milch", "Brot", "Eier", "Käse"
- Batch multiple searches in one call for efficiency:
{"queries":[{"keyword":"A"},{"keyword":"B"}]} - Each query object supports:
keyword, sort_type, filters - Sort:
orderPriceAsc, orderPriceDesc, recommended (default) - Filters available:
news (new products), sales (on sale) - Include nutrition/allergens via
get_products_composition_batch after getting product IDs
Example Workflows
Weekly Shopping
# Search multiple items at once
gurkerl batch_search_products '{"queries":[{"keyword":"Milch"},{"keyword":"Brot"},{"keyword":"Eier"}]}'
# Add to cart
gurkerl add_items_to_cart '{"items":[{"productId":MILK_ID,"quantity":2},{"productId":BREAD_ID,"quantity":1}]}'
# Review cart
gurkerl get_cart
Reorder Last Order
gurkerl fetch_orders '{"limit":1}' # Get order ID
gurkerl repeat_order '{"order_id":ORDER_ID}'
Find Recipe & Add Ingredients
gurkerl search_recipes_by_vector_similarity '{"query":"schnelles Abendessen"}'
gurkerl get_recipe_detail '{"recipe_id":RECIPE_ID,"include_product_mapping":true}'
# Add matched products to cart
