Skip to main content
Glama
igorsafonov-gif

Mercadona MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MERCADONA_STATE_PATHNoOverride path for storage state file (default ~/.mercadona/storage_state.json).
MERCADONA_BROWSER_CHANNELNoBrowser channel to use for login (default chrome).chrome

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_shopping_guideA

Return the Mercadona shopping playbook: how to present products (ALWAYS as a photo-grid artifact), fill and review the real cart, use 'my regulars', and reorder past shops. Call this once at the start of any Mercadona task — before searching or adding to the cart — and follow it.

auth_statusA

Check whether the Mercadona session is valid and how long the token lasts.

loginA

Open a browser window to sign in to Mercadona. The user logs in (and handles any 2FA/SCA); the session is then saved so all other tools work. Call this when not signed in, or when a tool reports the session expired.

search_productsA

Find a product and its id (needed before add_to_cart), scoped to the user's delivery area. Use a short term; prefer the house brand 'Hacendado' unless asked otherwise. Returns matches with ids and prices.

get_productA

Get details for a single product by id.

get_cartB

Show the current real shopping cart (items, quantities, total).

get_my_regularsA

Products you usually buy. kind='precision' = most bought; kind='recall' = also bought.

get_purchase_historyB

List past orders (date, total, status, item count). Page is 1-based.

get_order_itemsA

List the products in a past order (without adding anything). Defaults to the most recent order if order_id is omitted.

get_delivery_slotsA

Available delivery slots. Uses your first address if address_id is omitted.

add_to_cartA

Add a product to the real cart by id (get the id from search_products or get_my_regulars first). If already present, increases the quantity. Returns the updated cart with its total.

set_quantityA

Set the exact quantity of a product in the cart. Quantity 0 removes it. Returns the updated cart.

remove_from_cartB

Remove a product from the cart entirely. Returns the updated cart.

reorder_orderA

Add all items from a past order to the cart in one step (a 'buy again'). Defaults to the most recent order. Skips items no longer available and reports them. Returns the updated cart.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/igorsafonov-gif/mercadona-claude-extension'

If you have feedback or need assistance with the MCP directory API, please join our Discord server