Shufersal MCP Server

MCP server for shufersal automation using Puppeteer

Local serverstdio

What is the Shufersal MCP MCP server?

MCP server for shufersal automation using Puppeteer. The shufersal mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 11 defined tools rather than through you.

What it actually does

A Model Context Protocol server that provides automated shopping capabilities for the Shufersal website using Puppeteer. This server enables LLMs to interact with Shufersal's online shopping platform, search for products, create shopping lists, and add items to your cart.

  • Product Search — Search Shufersal's product catalog, logged in user will get personalized results
  • Cart Management — Add products to your Shufersal shopping cart
  • Browser Automation — Seamless interaction with the Shufersal website
  • Shopping List Management — Create structured shopping lists from web links (e.g. recipe links)
  • Console Monitoring — Track console logs from the browser automation (for debugging)

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Its toolset

Everything the assistant can do here goes through one of these:

  • open_shufersal — Open the Shufersal website and prepare for shopping (requires user login)
  • Input — hasCreatedShoppingList (boolean): Whether a shopping list has been created beforehand
  • search_shufersal — Search for products on Shufersal website (results sorted by purchase history)
  • add_to_shufersal_cart — Add a product to the shopping cart (must be used after searching)
  • Inputs — - product_id (string): Product ID from search results
  • read_webpage_content — Read and convert webpage content to markdown format
  • create_shopping_list_table — Create a shopping list table in markdown format from recipe ingredients
  • Tools — The Tools tool exposed by this server
  • Resources — 1. Console Logs (console://logs) - Browser console output in text format - Includes all console messages from the browser automation
  • Building — The Building tool exposed by this server
  • Linting — The Linting tool exposed by this server

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Shufersal MCP.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the shufersal mcp mcp server does with a few real requests.

When to reach for it

This sits in the browser automation group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Shufersal MCP's toolset — open_shufersal, Input, search_shufersal and 8 more — is a fair guide to whether it matches your workflow. It is maintained by matipojo; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
open_shufersalOpen the Shufersal website and prepare for shopping (requires user login)
InputhasCreatedShoppingList (boolean): Whether a shopping list has been created beforehand
search_shufersalSearch for products on Shufersal website (results sorted by purchase history)
add_to_shufersal_cartAdd a product to the shopping cart (must be used after searching)
Inputs- product_id (string): Product ID from search results
read_webpage_contentRead and convert webpage content to markdown format
create_shopping_list_tableCreate a shopping list table in markdown format from recipe ingredients
ToolsThe Tools tool exposed by this server.
Resources1. **Console Logs** (console://logs) - Browser console output in text format - Includes all console messages from the browser automation
BuildingThe Building tool exposed by this server.
LintingThe Linting tool exposed by this server.

How to install the Shufersal MCP MCP server

{
  "mcpServers": {
    "shufersal": {
      "command": "node",
      "args": ["<path/to/shufersal-mcp>/dist/index.js"],
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Shufersal MCP to open shufersal.
  • Use Shufersal MCP to Input.
  • Use Shufersal MCP to search shufersal.

Frequently asked questions

It connects Shufersal MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 11 tools (open_shufersal, Input, search_shufersal, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Shufersal MCP directly.