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: - GURKERL_EMAIL - GURKERL_PASS tags: - grocery - shopping - austria - mcp - rohlik - delivery

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

Gurkerl.at Grocery Shopping