Rohlik

You can extend your AI assistant with Rohlik grocery shopping capabilities by running an MCP server that exposes core shopping actions, smart shopping insights, and account information. This enables conversational agents to search products, manage carts, view orders, and plan deliveries across multiple Rohlik regions.

How to use

You enable and use the Rohlik MCP Server by running it locally or hosting it as a service, then connecting your MCP client (such as Claude Desktop) to the provided MCP endpoint. You can perform practical tasks like searching for groceries, adding items to your cart, retrieving cart contents, and getting personalized meal or shopping recommendations based on your order history.

How to install

Prerequisites you need before starting:

• Node.js installed on your system
• NPM available
• A Rohlik account for testing (credentials used by the MCP)

Configuration and usage examples

{
  "mcpServers": {
    "rohlik": {
      "command": "npx",
      "args": ["-y", "@tomaspavlin/rohlik-mcp"],
      "env": {
        "ROHLIK_USERNAME": "your-email@example.com",
        "ROHLIK_PASSWORD": "your-password",
        "ROHLIK_BASE_URL": "https://www.rohlik.cz"
      }
    },
    "rohlik-local": {
      "command": "node",
      "args": ["/path/to/rohlik-mcp/dist/index.js"],
      "env": {
        "ROHLIK_USERNAME": "your-email@example.com",
        "ROHLIK_PASSWORD": "your-password",
        "ROHLIK_BASE_URL": "https://www.rohlik.cz"
      }
    }
  }
}

Supported regions and base URLs

You choose regional endpoints by setting the base URL for Rohlik. If not specified, it defaults to the Czech site. Available regions include Czech Republic, Germany, Austria, Hungary, Romania, with Italy and Spain planned. Use these base URLs as the ROHLIK_BASE_URL value in your MCP configuration.

What you can do with the MCP

Core shopping actions let you search for products, add items to carts, view or modify cart contents, and fetch shopping lists. Smart shopping actions provide meal suggestions, frequent item analysis, and personalized shopping scenarios. You can also retrieve account data, order history, upcoming deliveries, delivery slots, and premium status.

Troubleshooting and tips

If you encounter login or API issues, enable a debug mode by adding a debug flag to the environment. Check logs for authentication problems, network issues, or endpoint changes. If search results are missing, try broader terms or partial names and verify item availability on Rohlik’s site.

Security and privacy notes

Use strong credentials and limit access to the MCP server. Do not store credentials in public repositories or shared scripts. Enable debug mode only in secure environments and monitor logs for any unexpected activity.

Development and testing

You can run unit tests and API validation to ensure endpoints work correctly. Use the test and validate scripts provided in the project to verify functionality and generate reports.

Available tools

search_products

Search for grocery products by name with filtering options.

add_to_cart

Add multiple products to your shopping cart.

get_cart_content

View current cart contents and totals.

remove_from_cart

Remove items from your shopping cart.

get_shopping_list

Retrieve shopping lists by ID.

get_meal_suggestions

Get personalized meal and shopping suggestions based on order history.

get_frequent_items

Analyze order history to find most frequently purchased items.

get_shopping_scenarios

Interactive guide showing what you can do with the MCP.

get_account_data

Fetch comprehensive account information including delivery details and cart status.

get_order_history

View past delivered orders with details.

get_order_detail

Get detailed information about a specific order.

get_upcoming_orders

See scheduled upcoming orders.

get_delivery_info

Get current delivery information and fees.

get_delivery_slots

View available delivery time slots for your address.

get_premium_info

Check Rohlik Premium subscription status and benefits.

get_announcements

View current announcements and notifications.

get_reusable_bags_info

Track reusable bags and environmental impact.