Skill: Gurkerl.at Grocery Shopping

Owner: florianbeer

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

Tags: latest:1.0.0

Version history:

v1.0.0 | 2026-01-25T20:47:15.032Z | user

Initial release: 47 MCP tools for Austrian grocery shopping - products, cart, orders, recipes, favorites

Archive index:

Archive v1.0.0: 2 files, 2466 bytes

Files: SKILL.md (5323b), _meta.json (126b)

File v1.0.0:SKILL.md

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/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

File v1.0.0:_meta.json

{ "ownerId": "kn700p24jn7snwp1wmr0801k9x7zx80x", "slug": "gurkerl", "version": "1.0.0", "publishedAt": 1769374035032 }