Gurkerl

Gurkerl.at grocery shopping via MCP - search products, manage cart, orders, recipes, favorites.

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:

bash

export GURKERL_EMAIL="[e-mail]"
export GURKERL_PASS="your-password"

For persistent access, add to ~/.config/systemd/user/openclaw-gateway.service.d/gurkerl.conf:

ini

[Service]
Environment="GURKERL_EMAIL=[e-mail]"
Environment="GURKERL_PASS=your-password"

CLI Usage

bash

# 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

bash

# 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

bash

gurkerl fetch_orders '{"limit":1}'  # Get order ID
gurkerl repeat_order '{"order_id":ORDER_ID}'

Find Recipe & Add Ingredients

bash

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