rappi-mcp 0.2.1

MCP server for Rappi Chile — browse stores, search products, manage cart and checkout via Claude

RappiMCP

Program : RappiMCP
Author  : Bastian Girardi
Date    : April 2, 2026
Purpose : Built to automate grocery and delivery purchases on Rappi Chile
          through Claude — eliminating the need to manually browse the app
          when you just want to tell an AI what you need and have it ordered.

---

An MCP (Model Context Protocol) server that gives Claude full control over Rappi Chile — browse stores, search products, manage the cart, and open checkout — all through natural language.

How it works

The server is built with FastMCP and exposes tools that Claude can call. It communicates with Rappi via their internal web API (services.rappi.cl), authenticated with tokens extracted directly from a Chrome browser session using the Chrome DevTools Protocol (CDP).

Claude ──tools──▶ rappi_mcp.py ──HTTP──▶ services.rappi.cl
                       │
                       └──CDP──▶ Chrome (auth + checkout navigation)

Setup

1. Install dependencies

pip install -r requirements.txt

2. Configure Claude Code

Add this to your Claude Code MCP settings (claude_desktop_config.json or equivalent):

{
  "mcpServers": {
    "RappiMCP": {
      "command": "python",
      "args": ["C:/path/to/RappiMCP/rappi_mcp.py"]
    }
  }
}

3. Authenticate

On first use, call rappi_auth to extract your Rappi credentials from Chrome and save them to .env. No manual token copying needed.

Authentication

Rappi uses rotating JWT tokens stored as browser cookies. The auth flow:

1. rappi_auth(use_existing_chrome=False) — launches a dedicated Chrome window at rappi.cl (on CDP port 9223) and waits up to 2 minutes for you to log in
2. Once logged in, it reads three cookies via CDP:
   • rappi.data (Base64 JSON) → user_id
   • deviceid → device_id
   • rappi_refresh_token → refresh_token
3. Exchanges the refresh token for a fresh access_token via POST /api/rocket/refresh-token
4. Writes all four values to .env

rappi_auth(use_existing_chrome=True) (default) — attaches to an already-running Chrome with --remote-debugging-port=9223 and reads cookies immediately (you must already be logged in).

Token refresh

RappiClient handles token rotation automatically. If any API response includes the header x-refresh-token: true, it transparently refreshes both tokens and retries the request.

Environment variables

RAPPI_ACCESS_TOKEN   — Bearer token for API calls
RAPPI_REFRESH_TOKEN  — Used to obtain new access tokens
RAPPI_DEVICE_ID      — UUID identifying the browser session
RAPPI_USER_ID        — Numeric Rappi user ID

See .env.example for the expected format.

Tools reference

rappi_auth(use_existing_chrome=True)

Extract credentials from Chrome and write them to .env. Set use_existing_chrome=False to launch a fresh Chrome window and wait for login.

---

rappi_reload()

Reload tokens from .env and restart the API client — without restarting the MCP server. Useful after manually editing .env.

---

rappi_list_stores(category, query, limit)

List stores available for delivery near your saved address.

Param	Default	Description
category	"market"	Store category: "market", "restaurant", "farma", "licores", "express-big", or any Rappi store_type slug
query	""	Optional name filter
limit	50	Max results

Returns: store_id, name, store_type, lat, lng, eta, shipping_cost.

store_id is used by rappi_search_products. store_type is used by all cart tools.

---

rappi_get_store(store_id)

Look up metadata for a specific store by its numeric ID. Returns store_type (the slug needed for cart operations).

---

rappi_search_products(store_id, query, size, offset)

Search products within a store. Queries in Spanish work best.

Param	Default	Description
store_id	required	From rappi_list_stores
query	required	Search term (e.g. "cerveza", "preservativos")
size	40	Results per page (max 40)
offset	0	Pagination offset

Returns: composite_id, name, trademark, price, real_price, discount, quantity, unit_type, sale_type, in_stock.

Use composite_id and sale_type when adding to cart.

---

rappi_get_cart(store_type)

Read the current cart contents for a given store. Returns a list of items with composite_id, units, sale_type, name, price.

---

rappi_add_to_cart(store_id, store_type, composite_id, units, sale_type)

Add a product to the cart (or increment its quantity if already present). Internally: reads current cart → appends/increments → writes back via a full PUT.

---

rappi_remove_from_cart(store_id, store_type, composite_id)

Remove a specific product from the cart by its composite_id.

---

rappi_clear_cart(store_id, store_type)

Empty the entire cart for a store.

---

rappi_checkout(store_type)

Navigate Chrome to the checkout page for a store. Each store has its own checkout URL:

https://www.rappi.cl/checkout/{store_type}

Examples:

• turbo_rappidrinks_nc → rappi.cl/checkout/turbo_rappidrinks_nc
• cruz_verde_rappido_nc → rappi.cl/checkout/cruz_verde_rappido_nc
• lider → rappi.cl/checkout/lider

Rappi does not support consolidated multi-store checkout. Each store cart must be checked out separately.

Typical flow

1. rappi_auth()                          # authenticate once
2. rappi_list_stores(category="farma")   # find pharmacies
3. rappi_search_products(store_id, "preservativos")  # search
4. rappi_add_to_cart(store_id, store_type, composite_id, 1, "U")
5. rappi_checkout(store_type)            # open checkout in Chrome

File structure

RappiMCP/
├── rappi_mcp.py      # MCP server — tool definitions, auth logic, CDP helpers
├── rappi_client.py   # Rappi API client with automatic token refresh
├── requirements.txt  # Python dependencies
├── .env              # Credentials (git-ignored)
└── .env.example      # Credentials template

Notes

• The server uses CDP port 9223 (not the default 9222) to avoid conflicts with other tools
• Checkout navigation also uses CDP — the same Chrome instance used for auth
• store_type slugs come from rappi_list_stores and must be passed exactly as returned (e.g. "turbo_rappidrinks_nc", not "turbo")