Tapsi Food

tapsifood-mcp: Tapsi Food MCP server for AI agents

Let your AI agent shop around on Tapsi Food (تپسی‌فود).

An unofficial, read-only MCP server for Tapsi Food, the food and grocery delivery service in Iran:

search dishes and restaurants near an address, read live menus and reviews, check delivery fees and minimum orders, and catch Tap Time flash deals, from Claude, Cursor or Copilot.

For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related

---

For AI agents

• What: unofficial MCP server (model context protocol) for Tapsi Food (tapsi.food), food and grocery delivery in Iran. Not Snappfood. Queries in Persian match best; prices in Toman.
• Install: uvx tapsifood-mcp or claude mcp add tapsifood -- uvx tapsifood-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Tapsi Food hangs connections from non-Iranian IPs: run it from Iran without a VPN, or set TAPSIFOOD_MCP_PROXY to an HTTP proxy that exits in Iran.
• Access: read-only. No login, basket, orders or payment, so no confirmation is needed before calling any tool.
• Tools: 11, all prefixed tf_. Most need lat and long (not tf_reviews, tf_find_location, tf_list_cities). Typical sequence: tf_find_location -> tf_search_dishes -> tf_vendor_info (-> tf_menu, tf_reviews).
• Use when: the user wants to find a dish or restaurant near an address in Tehran, Mashhad or Shiraz, compare prices and fees, read a menu or reviews, or find discounts.
• Do not use when: the user wants to order, pay or log in, or asks about a city Tapsi Food does not serve.
• Coverage: Tehran, Mashhad, Shiraz. Elsewhere the API answers 404 or OutOfCoverage.
• Output: compact JSON. Prices in Toman, ratings 0-5. Null and empty fields are omitted (a missing rating = not rated). Menu descriptions are cut to 100 characters and review comments to 250 (full_text: true for the whole text). Replies stay under about 15 KB at the maximum limit.
• Machine-readable: server.json and the iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

Picking dinner on a delivery app means opening a restaurant, scrolling the menu, then finding out the delivery fee and minimum order. Asking "what is the cheapest burger near me that is open now, and what will it really cost?" takes many taps. With tapsifood-mcp an agent finds the dish, then checks the restaurant's fee, packaging and minimum order for your address, and answers with the true cost: dish price minus discount plus packaging plus delivery fee.

You: Cheapest pizza near Valiasr Square, and is it worth the delivery fee?

Agent: *calls* tf_find_location -> tf_search_dishes(sort="cheapest") -> tf_vendor_info

It lists the cheapest open matches with price and discount, then checks the chosen restaurant's delivery fee to

your point, its minimum order and its status.

What it can do

• Geocode a place name or address to coordinates, reverse a point back to an address, and list the cities Tapsi Food shows
• Search dishes by name near a delivery point, sorted by relevance, cheapest, biggest discount, rating or distance
• Search restaurants and stores by name or cuisine near a point
• Browse restaurants or grocery stores with rating, delivery fee, minimum order and ETA, filtered by cuisine, discount, courier or new vendors
• Catch deals: Tap Time (تپ تایم) flash deals and the Food Shots (فودشات) discount campaign
• Read a live menu: every dish with price, discount and stock
• Check a vendor before ordering: delivery fee to your point, minimum order, packaging, ETA, open or closed, hours, address and rating spread
• Read reviews with the rating of each ordered dish
• Read-only by design: no login, no basket, no orders, no payment

Example prompts:

• "Find the cheapest burger near Enghelab Square in Tehran that is open now."
• "Which restaurants near me have a discount and a delivery fee under 30,000 Toman?"
• "Show the menu of this restaurant and tell me its minimum order."
• "What are the Tap Time flash deals around Azadi Tower right now?"
• "Read the latest reviews of this restaurant. Are people happy with the delivery?"
• ارزان‌ترین پیتزا نزدیک میدان ولیعصر کدام است؟
• رستوران‌های تخفیف‌دار نزدیک من را با هزینه ارسال و حداقل سفارش نشان بده.
• تپ تایم امروز چه غذاهایی دارد؟

Quick start

You need uv. No API key or account. Run it from Iran, or add TAPSIFOOD_MCP_PROXY (see Configuration).

Claude Code

claude mcp add tapsifood -- uvx tapsifood-mcp

behind a proxy that exits in Iran:

claude mcp add tapsifood -e TAPSIFOOD_MCP_PROXY=http://127.0.0.1:8080 -- uvx tapsifood-mcp

</details>

Claude Desktop

Settings → Developer → Edit Config, then add:

{

"mcpServers": { "tapsifood": { "command": "uvx", "args": ["tapsifood-mcp"] } } }

</details>

Cursor

Add the Claude Desktop block above to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

{

"servers": { "tapsifood": { "type": "stdio", "command": "uvx", "args": ["tapsifood-mcp"] } } }

</details>

Codex CLI

codex mcp add tapsifood -- uvx tapsifood-mcp

Or in ~/.codex/config.toml:

[mcp_servers.tapsifood]

command = "uvx" args = ["tapsifood-mcp"]

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

"mcpServers": { "tapsifood": { "command": "uvx", "args": ["tapsifood-mcp"] } } }

</details>

Windsurf

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

Anything else

It is a standard stdio MCP server: run uvx tapsifood-mcp, or pip install tapsifood-mcp and run tapsifood-mcp.

Tools

Start with a place: tf_find_location or tf_list_cities give the lat and long the other tools need. Vendor codes look like 2y97wk.

Location (3)

Find food and restaurants (5)

Vendor details (3)

All 11 tools are annotated readOnlyHint: true and return compact JSON.

How it works

  AI agent  (Claude, Cursor, Copilot, ...)

│ │ MCP over stdio ▼ tapsifood-mcp (runs on your machine) │ │ HTTPS └──────▶ api.tapsi.food dishes, vendors, menus, reviews, deals

tapsifood-mcp runs locally and calls the same endpoints the tapsi.food web app uses. There is no hosted server in between and no API key. Requests go out through a Chrome-impersonating client, at most 2 at a time with a little jitter. GET answers are cached for 60 seconds, a timeout, network error, 5xx or 429 is retried up to twice, and it only talks to api.tapsi.food. It only reads.

Good to know

• Prices are in Toman, as the API sends them. Ratings are 0-5.
• Delivery depends on the point. Menus, fees and coverage change with the latitude and longitude you pass. HTTP 200 does not mean the vendor delivers there: delivery_fee: null means out of coverage.
• Coverage: Tehran, Mashhad and Shiraz. Elsewhere feeds answer 404, search finds nothing and the menu says OutOfCoverage.
• Network: Tapsi Food hangs connections from non-Iranian IPs (a timeout on every call is the sign). Run it from Iran without a VPN, or set TAPSIFOOD_MCP_PROXY. System proxy variables are ignored on purpose.
• Open vendors only in search. Dish and vendor search list only restaurants open now (the site does the same), so at night total can be 0. tf_restaurants and tf_discounted_vendors also list closed vendors, flagged open: false.
• Search-index prices can lag the menu: confirm with tf_menu. Menu and profile minimums sometimes differ; tf_vendor_info returns both (min_order, min_order_profile).
• Sorting dishes: top_rated, cheapest and biggest_discount sort the first 100 matches, not the whole result set.
• ETA is an upper bound: eta_max is the site's "up to N minutes"; the API sends no lower bound.
• Reviews: total counts every review including rating-only ones; only reviews with a comment are listed, so a page can hold fewer than limit (keep paging while has_more). Writer names are left out on purpose.
• Browse pages: page 1 also carries filter and banner widgets, so it lists fewer vendors than page_size.
• What it does not do: no login, basket, orders or payment. Coupons are not exposed by the site's anonymous API.

FAQ

Is there a Tapsi Food API or MCP server for AI agents?

Ta