claudeers.
// MCP Servers

snapp-mcp

Unofficial read-only MCP server for Snappfood and SnappMarket (اسنپ‌فود), Iran: search food and groceries near you, compare prices, find deals. For Claude, C…

// MCP Servers[ cli ][ api ][ desktop ][ web ][ claude ]#claude#ai-agents#claude-code#cursor#food-delivery#grocery#iran#mcp#mcp-servers◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit 11 days ago
last release 12 days ago
releases 9
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up snapp-mcp (pip project) into my current project.
Found on https://claudeers.com/snapp-mcp
Repo: https://github.com/sepehr071/snapp-mcp
Homepage/docs: https://pypi.org/project/snapp-mcp/
Detected install method: pip → pip install snapp-mcp
Category: mcp-servers. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (pip)
pip install snapp-mcp
// or clone
git clone https://github.com/sepehr071/snapp-mcp

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
snapp-mcp: unofficial Snappfood and SnappMarket MCP server for Claude, Cursor and Copilot

snapp-mcp: Snappfood and SnappMarket MCP server for AI agents

Let your AI agent shop around on Snappfood and SnappMarket (اسنپ‌فود و اسنپ‌مارکت).
An unofficial, read-only MCP server for Iran's food delivery and grocery apps: search dishes and groceries,
compare real prices across hundreds of restaurants and stores, read menus and reviews, and catch today's flash deals, all from Claude, Cursor or Copilot.

For AI agents · Quick start · What it can do · Tools · FAQ · فارسی


For AI agents

  • What: unofficial MCP server for Snappfood (snappfood.ir, restaurant delivery) and SnappMarket (snapp.market, groceries) in Iran. Queries in Persian match best; prices in Toman.
  • Install: uvx snapp-mcp or claude mcp add snapp -- uvx snapp-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none, no API key or account. Snappfood only accepts Iranian IPs: run it from Iran without a VPN, or set SNAPP_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: 21: find_location, reverse_geocode, list_cities, then food_* and market_*. Most food and market tools need lat and long (not food_reviews, market_reviews, market_product, list_cities). Typical sequence: find_location -> food_find_cheapest -> food_order_costs (groceries: market_find_cheapest -> market_store_info).
  • Use when: comparing the real total (food + packaging + delivery) of dishes or groceries near an address in Iran.
  • Do not use when: the user wants to order, or is outside Iran with no Iranian IP or proxy (Snappfood answers HTTP 403).
  • Output: compact JSON. Prices in Toman, ratings 0-5 (null = not rated). Restaurant and store vendor_code values pass between tools. FoodParty and Gem deals only run in time windows.
  • Machine-readable: server.json and the awesome-iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

Snappfood shows you one restaurant at a time. Finding the cheapest pizza that actually reaches your door means opening dozens of menus, adding packaging and delivery fees in your head, and checking each restaurant's minimum order. An agent with snapp-mcp does that in seconds:

You: Cheapest pizza delivered to Vanak Square right now, including delivery?

Agent: calls find_location(query="میدان ونک") → food_find_cheapest(query="پیتزا", lat=35.7577, long=51.4095)

TotalDishRestaurantBreakdown
296,400پیتزا سوسیس مینی + نوشابهپیتزاتو (گاندی)food 296,400 · free delivery
410,000پیتزا اسمارت وجی لاورپیتزا دومینوز (جردن)food 360,000 + delivery 50,000
464,000پیتزا پپرونی اسلایسیتله پیتزا (سعادت آباد)food 315,000 + delivery 149,000

The Pizzato combo is cheapest overall. Want me to check its minimum order and coupons with food_order_costs?

Real tool output from 2026-10-02; prices change all the time. Prices are in Toman.

What it can do

  • 🔎 Search dishes and grocery products by name near any address in Iran
  • 💸 Find the true cheapest option: food price after discount + packaging + delivery, checked against live menus
  • 🏪 Browse restaurants and stores with filters: free delivery, discount, coupon, rating, distance
  • 📋 Read full menus, store catalogs, minimum orders, delivery fees, ETAs and coupons
  • ⚡ Catch deals: FoodParty flash deals, meals for one, Gem hunts, Market Party
  • ⭐ Check quality with customer reviews before recommending anything
  • 🔒 Read-only by design: no login, no basket, no orders, no payment

Quick start

You need uv and an Iranian IP address (Snappfood blocks most foreign IPs; see FAQ).

Claude Code
claude mcp add snapp -- uvx snapp-mcp
Claude Desktop

Settings → Developer → Edit Config, then add:

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

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

VS Code (Copilot agent mode)

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

{
  "servers": {
    "snapp": { "type": "stdio", "command": "uvx", "args": ["snapp-mcp"] }
  }
}
Anything else

It's a standard stdio MCP server: run uvx snapp-mcp, or pip install snapp-mcp and run snapp-mcp.

Then just ask:

  • "Which restaurants near Tajrish have free delivery and at least 4.5 stars?"
  • "Show FoodParty deals with more than 40% off near me."
  • "Where is low-fat milk cheapest near Jordan, Tehran? Include delivery."
  • ارزان‌ترین کباب نزدیک میدان آزادی شیراز با هزینه ارسال؟

How it works

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  snapp-mcp  (runs on your machine, uses your IP)
      │
      │  HTTPS
      ├──────▶  snappfood.ir    restaurants
      └──────▶  snapp.market    groceries

snapp-mcp runs locally and calls the same public endpoints the Snappfood and SnappMarket web apps use. There's no hosted server in between, no API key, and nothing about you is sent anywhere else.

Tools

Every food and grocery tool takes lat / long, because menus, prices and delivery fees depend on the delivery point. The agent gets them from find_location or list_cities first.

📍 Location (3)
ToolWhat it does
find_locationAddress, landmark or street → coordinates
reverse_geocodeCoordinates → street / neighbourhood names
list_citiesEvery served city with its center point
🍔 Snappfood: restaurants (9)
ToolWhat it does
food_searchSearch dishes by name; price sorts are re-checked against live menus
food_find_cheapestScan nearby menus + FoodParty for the lowest total price (food + packaging + delivery)
food_restaurantsRestaurants with filters (free delivery, discount, coupon) and sorting
food_menuOne restaurant's full menu with prices, packaging fees and availability
food_order_costsDelivery fee, ETA, minimum order and coupons of one restaurant
food_reviewsCustomer reviews, with what they ordered and the restaurant's reply
food_party_dealsFoodParty flash deals still in stock, with the deal window
food_meal_for_oneSingle-person meals up to 299k Toman with free delivery
food_discounted_vendorsRestaurants running discounts now, plus live Gem deals
🛒 SnappMarket: groceries (9)
ToolWhat it does
market_searchSearch a product across stores, grouped by store
market_find_cheapestCheapest in-stock offers for a product, one flat list
market_storesStores delivering to a point, by delivery fee or rating
market_store_infoDelivery fee, minimum order, opening hours and coupons of a store
market_store_productsSearch inside a store, or browse it by category
market_categoriesProduct categories and their ids
market_productOne product's details and price in a store
market_party_dealsMarket Party flash deals, biggest discount first
market_reviewsCustomer comments on a store

All 21 tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.

Good to know

  • Prices are in Toman (1 Toman = 10 Rial). Ratings are normalized to 0–5, like the apps; null means not rated yet.
  • True cost of a food order = price − discount + packaging + delivery − coupon, and the basket must reach the restaurant's minimum order. food_find_cheapest and food_order_costs give the agent every piece of that.
  • Persian queries match best (پیتزا, کباب, شیر). Name filters treat Arabic ي/ك and half-space vs space as equal.

FAQ

Is there a Snappfood or SnappMarket API or MCP server for AI agents?

Yes: snapp-mcp is an unofficial MCP server with 21 read-only tools for dishes, menus, groceries, delivery fees and deals. It calls the same public endpoints the Snappfood and SnappMarket web apps use; no API key is needed.

How do I use Snappfood with Claude, Cursor or Copilot?

Add the server with claude mcp add snapp -- uvx snapp-mcp (or the matching config in Quick start for Claude Desktop, Cursor and VS Code), then ask for a dish near an address, in Persian or English.

Is it official, safe and free? Does it work outside Iran?

It is unofficial and not affiliated with Snapp. It is read-only (no login, basket or payment), runs on your machine, and is free under the MIT license. Outside Iran, Snappfood blocks most IPs, so use an Iranian IP or SNAPP_MCP_PROXY.

I get "blocked the request (HTTP 403)"

Snappfood's firewall only accepts Iranian IP addresses. Run the server on a machine in Iran with the VPN off. If you must use a VPN, set SNAPP_MCP_PROXY to an HTTP proxy that exits in Iran. Normal system proxy variables are ignored on purpose, because a foreign VPN exit would get blocked. SnappMarket is less strict.

Can it place an order for me?

No, and that's deliberate. It has no login and never touches the basket, order or payment endpoints. The agent finds the best option; you tap order in the app.

FoodParty or Gem results are empty

Those deals only run in time windows. active: false or gem: null means no window is live right now.

Claude Desktop says uvx is not found

Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.

How do I debug what the agent sees?
npx @modelcontextprotocol/inspector uvx snapp-mcp

Configuration

VariableDefaultMeaning
SNAPP_MCP_PROXYunsetHTTP proxy for every request, e.g. http://user:pass@host:port

فارسی: سرور MCP اسنپ‌فود و اسنپ‌مارکت

snapp-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای اسنپ‌فود و اسنپ‌مارکت در ایران است. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد در اسنپ‌فود و اسنپ‌مارکت جستجو کند، قیمت واقعی غذا و کالا را بین صدها رستوران و فروشگاه مقایسه کند، منو و نظرات را بخواند و تخفیف‌های فعال (فودپارتی، جم، مارکت‌پارتی) را پیدا کند.

  • فقط خواندنی است: وارد حساب نمی‌شود، سبد خرید نمی‌سازد و سفارش ثبت نمی‌کند.
  • قیمت نهایی را با بسته‌بندی، هزینه ارسال و حداقل سفارش حساب می‌کند.
  • روی سیستم خود شما اجرا می‌شود و به هیچ سرور واسطی داده نمی‌فرستد.

نصب در Claude Code:

claude mcp add snapp -- uvx snapp-mcp

بعد بپرسید: «ارزان‌ترین پیتزا با هزینه ارسال نزدیک میدان ونک کجاست؟»

نکته: سرور باید روی سیستمی با IP ایران و بدون VPN اجرا شود، چون اسنپ‌فود درخواست‌های خارج از ایران را مسدود می‌کند.

Development

git clone https://github.com/sepehr071/snapp-mcp && cd snapp-mcp
uv sync
uv run pytest            # offline, against recorded responses
uv run pytest -m live    # real APIs (needs an Iranian IP)
uv run ruff check .

Tools live in src/snapp_mcp/food.py, market.py and location.py; each is a typed async function with a docstring that tells the agent when to use it. Issues and PRs are welcome, especially new tools and fixes for API changes.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions tests, publishes to PyPI and the MCP Registry, and creates the GitHub Release.

Disclaimer

Unofficial and not affiliated with or endorsed by Snapp. It uses the public endpoints of the snappfood.ir and snapp.market web apps, which can change without notice. Please keep request rates reasonable.

License

MIT

If this saves you clicks, a star helps others find it.

// faq

What is snapp-mcp?

Unofficial read-only MCP server for Snappfood and SnappMarket (اسنپ‌فود), Iran: search food and groceries near you, compare prices, find deals. For Claude, Cursor and Copilot via uvx.. It is open-source on GitHub.

Is snapp-mcp free to use?

snapp-mcp is open-source under the MIT license, so it is free to use.

What category does snapp-mcp belong to?

snapp-mcp is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

17 views
★ 38 stars
unclaimed
updated about 1 month ago

// embed badge

snapp-mcp on Claudeers
[![Claudeers](https://claudeers.com/api/badge/snapp-mcp.svg)](https://claudeers.com/snapp-mcp)

// retro hit counter

snapp-mcp hit counter
[![Hits](https://claudeers.com/api/counter/snapp-mcp.svg)](https://claudeers.com/snapp-mcp)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 175,627◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 151,540◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how snapp-mcp connects across the ecosystem