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)

Total	Dish	Restaurant	Breakdown
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 mcp add snapp -- uvx snapp-mcp

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

{
  "servers": {
    "snapp": { "type": "stdio", "command": "uvx", "args": ["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

flowchart LR
    A[AI agent: Claude, Cursor, Copilot] -->|MCP over stdio| S[snapp-mcp on your machine]
    S -->|HTTPS from your IP| F[snappfood.ir restaurants]
    S -->|HTTPS from your IP| M[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.

All 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

npx @modelcontextprotocol/inspector uvx snapp-mcp

Configuration

فارسی

claude mcp add snapp -- uvx snapp-mcp

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