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/clawdbot-gateway.service.d/gurkerl.conf:
[Service]
Environment="GURKERL_EMAIL=your@email.com"
Environment="GURKERL_PASS=your-password"
CLI Usage
# Search products (German keywords)
gurkerl search_products '{"keyword":"Milch"}'
gurkerl search_products '{"keyword":"Bio Eier","sort_type":"orderPriceAsc"}'
# 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 |
search_products |
Search by keyword, filters, sort. Use German keywords. |
get_products_details_batch |
Get details for multiple product IDs |
get_product_composition |
Nutritional info, allergens, ingredients |
get_category_products |
Browse products in a category |
get_main_categories |
List store categories |
get_brands_navigation |
List available brands |
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 |
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 |
change_order_timeslot |
Change delivery slot |
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 |
get_recipes_navigation |
Browse recipe categories |
User & Favorites
| Tool |
Description |
get_user_info |
Account profile |
get_user_credits |
Available credits/vouchers |
get_user_addresses |
Saved delivery addresses |
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 product to list |
Customer Care
| Tool |
Description |
submit_claim |
File warranty claim for missing/damaged items |
get_customer_support_contact_info |
Phone, email, WhatsApp |
get_user_reusable_bags_info |
Check bag deposit status |
adjust_user_reusable_bags |
Correct bag count |
Other
| Tool |
Description |
calculate_average_user_order |
Generate typical order from history |
get_faq_content |
FAQ for: general, xtra_general, xtra_price, baby_club, christmas |
fetch_all_job_listings |
Career opportunities |
Search Tips
- Use German keywords for Austrian Gurkerl: "Milch", "Brot", "Eier", "Käse"
- Filters available:
news (new products), sales (on sale)
- Sort:
orderPriceAsc, orderPriceDesc, recommended (default)
- Include nutrition:
"include_nutritions":true
- Include allergens:
"include_allergens":true
Example Workflows
Weekly Shopping
# Check what's on sale
gurkerl search_products '{"filters":[{"filterSlug":"sales","valueSlug":"sales"}]}'
# Add milk to cart
gurkerl search_products '{"keyword":"Milch"}' # Get product ID
gurkerl add_items_to_cart '{"items":[{"productId":MILK_ID,"quantity":2}]}'
# 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
modbender