snapp-mcp

An MCP server that lets AI agents use Snappfood (restaurant delivery) and SnappMarket (grocery delivery) in Iran. Agents can search dishes and groceries, compare prices across restaurants and stores, read menus and reviews, and find live deals.

It is read-only: it cannot log in, add to a basket or place an order.

Unofficial. Not affiliated with or endorsed by Snapp. It uses the same public endpoints as the snappfood.ir and snapp.market web apps, which can change without notice.

Example prompts

• "Cheapest pizza delivered to Vanak Square right now, including delivery fee."
• "Which restaurants near me in Shiraz have free delivery and a rating above 4?"
• "Show today's FoodParty deals with more than 40% off."
• "Where can I buy low-fat milk cheapest near Jordan, Tehran?"
• "Is restaurant 947evd's minimum order above 200,000 Toman? Any coupons?"

Requirements

• uv (provides uvx), or Python 3.10+ with pip.
• An Iranian IP address. Snappfood's firewall rejects most foreign IPs (HTTP 403). Run the server on a machine in Iran with VPN off, or point SNAPP_MCP_PROXY at a proxy in Iran. SnappMarket is less strict.

Install

Claude Code

claude mcp add snapp -- uvx snapp-mcp

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

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

Cursor

Add the same block to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

VS Code (Copilot agent mode)

Add to .vscode/mcp.json:

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

Any other MCP client

Run uvx snapp-mcp (or pip install snapp-mcp then snapp-mcp) as a stdio server.

Tools

Every food and grocery tool takes lat / long: menus, prices and delivery fees depend on the delivery point. Get them with find_location or list_cities first.

Location

Snappfood (restaurants)

SnappMarket (groceries)

All tools are annotated readOnlyHint: true. Results are compact JSON (structured content), so they do not use up the agent's context.

Conventions

• Prices are in Toman (1 Toman = 10 Rial).
• Ratings are normalized to 0-5, like the apps show. null means not rated yet.
• Persian queries match best: پیتزا, کباب, شیر.
• True cost of a food order: price - discount + packaging + delivery fee - coupon. The basket must also reach the restaurant's minimum order.

Configuration

Troubleshooting

• "blocked the request (HTTP 403)": your IP is outside Iran. Turn off the VPN, or set SNAPP_MCP_PROXY to a proxy in Iran.
• uvx not found in Claude Desktop: use the full path to uvx as command.
• Empty FoodParty / Gem results: these deals only run in time windows. active: false means no window is live.
• Debug with the MCP Inspector: npx @modelcontextprotocol/inspector uvx snapp-mcp.

Development

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

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions publishes to PyPI (trusted publishing) and to the MCP Registry.

License

MIT