English · فارسی

Iran MCP servers: awesome-iran-mcp

Give your AI agent the Iranian web. 19 unofficial, open-source Persian-web MCP servers for Digikala, Snappfood, Jabama, MrBilit, Paziresh24, Taaghche and more. Search, compare prices in Toman, find free slots and today's deals from Claude, Cursor, GitHub Copilot in VS Code or any MCP client. Install them as Claude Code plugins with skills, or as Agent Skills for Codex, Cursor, Antigravity and Grok Build.

Quick start · The servers · For AI agents · All tools · FAQ

Why

Iranian websites are not built for AI agents. Most have no public API, prices come in Rial on one page and Toman on the next, and every site hides its best deals behind a different menu. Each server here maps one site's real (undocumented) API, tests it, and exposes it as clean MCP tools with prices in Toman.

Put a few of them together and one sentence does a day of tab-hopping (illustrative example):

You: I'm flying Tehran to Kish next Thursday for 3 nights. Cheapest flight, a villa under 4 million Toman a night, and a dermatologist on the island with a free slot.

Agent: calls mrbilit for flights → jabama and otaghak for stays → paziresh24 for doctors

	Pick	Price (Toman)
Flight	Thursday 07:40, economy, 2 seats left	2,180,000
Stay	2-bedroom villa near the beach, 4.8 stars	3,650,000 / night
Doctor	Dermatologist, Saturday 10:30, in-person	450,000

Quick start

Every server is a small Python package on PyPI, run with uvx. No API key and no install step, except payping-mcp and bale-mcp, which act on your own account.

Claude Code plugins (server + skill, pick what you want): add the marketplace once, then choose servers in the /plugin Discover tab, or install by name.

claude plugin marketplace add sepehr071/awesome-iran-mcp
claude plugin install digikala@iran-mcp            # one server
claude plugin install iran-travel@iran-mcp         # a bundle: food, shopping, beauty, travel, health, books
claude plugin install iran-all@iran-mcp            # every read-only site server

claude plugin install <name> --marketplace sepehr071/awesome-iran-mcp does both steps in one command. payping and bale act on your own account, so no bundle includes them; install them by name.

Skills for other agents (Codex, Cursor, Gemini CLI, ...): pick the skills you want, then add each server with the config below.

npx skills add sepehr071/awesome-iran-mcp

Grok Build reads the same marketplace: grok plugin marketplace add sepehr071/awesome-iran-mcp, then install servers one by one (Grok doesn't install a bundle's members). Which agent supports what: PLUGINS.md.

One server (Claude Code, without the plugin):

claude mcp add digikala -- uvx digikala-mcp

Any MCP client (Claude Desktop, Cursor, Windsurf, VS Code, ...):

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

All 19 at once: clone this repo and open it in Claude Code. The .mcp.json at the root registers every server; approve the ones you want.

git clone https://github.com/sepehr071/awesome-iran-mcp
cd awesome-iran-mcp && claude

[!TIP] 308 tools is a lot of context. Enable the servers for the task at hand rather than all of them.

The servers

🛒 Shopping

Server	Site	Tools	Version	Updated	What your agent can do
digikala-mcp	Digikala (incl. Fresh)	23			Search with feature filters, best picks for a budget, every seller, price history, reviews, deals
technolife-mcp	Technolife	19			Electronics: each seller's cash and installment price, specs, reviews, deals
masterkala-mcp	MasterKala	14			Gadgets and accessories: prices, specs, deals
shopino-mcp	Shopino	14			Fashion from thousands of shops: prices, sizes, stock, shop ratings

💄 Beauty

Server	Site	Tools	Version	Updated	What your agent can do
khanoumi-mcp	Khanoumi	12			Cosmetics, skin and hair care, perfume: prices, shades, reviews, deals
asalbanoo-mcp	Asal Banoo	12			Cosmetics and hair care: prices, variants, deals

🍕 Food and groceries

Server	Site	Tools	Version	Updated	What your agent can do
snapp-mcp	Snappfood + SnappMarket	21			Cheapest dish near you, menus, FoodParty flash deals, groceries
okala-mcp	Okala	16			Grocery stores that deliver to you, prices across stores, deals

✈️ Travel and stays

Server	Site	Tools	Version	Updated	What your agent can do
mrbilit-mcp	MrBilit	22			Cheapest flights, trains, buses, taxis and hotels; seats and refund rules
flytoday-mcp	Flytoday	22			Flights, trains, buses, hotels, villas; CIP, eSIM, visas, activities
jabama-mcp	Jabama	21			Stays with exact prices, group tours, events and theater tickets
otaghak-mcp	[Otaghak](https