Iran MCP

English · فارسی

Iran MCP servers: iran-mcp

Give your AI agent the Iranian web.
68 unofficial, open-source Persian-web MCP servers for Digikala, Torob, Divar, Snappfood, Jabama, MrBilit, Alibaba, Neshan, Balad, Paziresh24, Taaghche, Jobinja, Bama, the Tehran stock exchange, Codal, the Central Bank, Iranian crypto exchanges, the tax administration, qavanin.ir laws and more, plus official ones from ExirYab, Pasavard and SwapWallet.
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.

Web catalog (in Persian): mcpfarsi.ir, the Persian MCP marketplace.

What's new · Quick start · The servers · For AI agents · All tools · FAQ

What's new in v2.4

• 6 new servers, all read-only and without sign-in: 77 servers and 994 tools in total.
• Insurance and companies (new categories): iran-insurance-mcp (BimeBazar and Azki quotes and insurer ratings side by side) and rasmio-mcp (the Rasmio company registry: board members, gazette ads, brands).
• Markets: iran-brokers-mcp (stocks, funds, options, bonds and screeners through brokers Mofid and Agah).
• Film and series (new category): iran-vod-mcp (Filimo and Namava: where to watch, episodes, new releases).
• Shops and jobs: snappshop-mcp (Snapp! Shop seller offers and flash sales) and iran-jobs-mcp (IranTalent, Jobinja and Jobvision side by side).
• Every server updated to its latest release. Each skill now names its maintainer.
• Bundle renamed: iran-jobs is now the iran-jobs-mcp server; the jobs bundle is iran-jobs-bundle.
• Tool names of the existing servers are unchanged.

Full list: CHANGELOG.md.

What's new in v2.3

• 31 new servers, all read-only and without sign-in: 71 servers and 883 tools in total.
• Cars: bama-ir-mcp, karnameh-mcp and hamrah-mechanic-mcp (car ads, daily and new-car prices), plus sheypoor-mcp classifieds.
• Maps and travel: neshan-mcp and balad-mcp (places, nearby search, directions with live traffic), alibaba-ir-mcp (flights, trains, buses, hotels, villas, tours) and eghamat24-mcp (hotels).
• Jobs and freelance: jobinja-mcp, jobvision-mcp, irantalent-mcp, quera-mcp, ponisha-mcp and karlancer-mcp.
• Markets and economy: codal-mcp (company filings), ifb-mcp (bonds and sukuk), fipiran-mcp (funds), ime-mcp (commodity exchange), cbi-mcp (Central Bank rates) and amar-mcp (official statistics). Most of these quote Rial, and several answer only Iranian connections.
• Shops, books, courses and health: emalls-ir-mcp, mobile-ir-mcp, zoomit-mcp, iranketab-mcp, faradars-mcp and darukade-mcp (online pharmacy).
• Sports, games, calendar and records: varzesh3-mcp, gamefa-mcp, time-ir-mcp, rrk-mcp (Official Gazette) and iran-cloud-status-mcp (ArvanCloud, Hamravesh, Chabokan, Liara).
• New bundles iran-cars, iran-maps, iran-jobs, iran-freelance, iran-economy, iran-stocks, iran-classifieds, iran-learning and iran-law.
• Tool names and parameters of the existing servers are unchanged.

Full list: CHANGELOG.md.

What's new in v2.0

• 12 new servers, all read-only and without sign-in: 36 servers and 469 tools in total.
• Shops and food: basalam-mcp (thousands of small shops), banimode-mcp (fashion), baneh-mcp (appliances, TVs, tools) and tapsifood-mcp (dishes and deals near an address).
• Prices, news and public records: tgju-mcp (gold, coin, currency and crypto), iran-news-mcp (10 news sources, plus a tech-news tool), iran-quake-mcp (earthquakes), qavanin-mcp (national laws) and iran-tax-mcp (e-invoice IDs, VAT rates, tax rulings).
• Courses, apps and software: maktabkhooneh-mcp (its tools start with mkh_), iran-apps-mcp (Cafe Bazaar and Myket) and iran-downloads-mcp (download-site search, item page only, never a download link).
• New bundles iran-fashion and iran-software.
• Tool names and parameters of the existing servers are unchanged.

Full list: CHANGELOG.md.

What's new in v1.7

• Fewer blocks and failed calls. The 18 unofficial shop servers now talk to each site like a normal browser, pace their requests and wait when a site asks them to slow down. On Torob the old client was blocked after 4-6 calls; the new one made 100 without a block.
• Proxy lists. <NAME>_MCP_PROXY takes several proxies, separated by commas. When one is blocked, the next takes over.
• Optional browser fallback for sites that show a bot-check page: install <package>[browser].
• New: torob-mcp (every Iranian shop's price for one product), pasavard-mcp (hosted, best buys per budget) and exiryab-mcp (ExirYab's own doctor finder).
• Tool names and parameters are unchanged.

Full list: CHANGELOG.md.

What's new in v1.5

• About 62% fewer tokens per tool call and a 19% smaller tool list across the 19 package servers, with the same rankings and cheapest prices as before.
• Security hardening in 30book, Bale and Okala, and site text is treated as untrusted in every server.
• Caches, parallel requests and retries where the servers were slow or fragile.
• New: divar-mcp, 31 tools for Divar classifieds: homes, cars, phones, fair-price checks and new-ad alerts.

Full list, including changes for callers: CHANGELOG.md.

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 package server here maps one site's real (undocumented) API, tests it, and exposes it as clean MCP tools with prices in Toman. exiryab-mcp, pasavard-mcp and swapwallet-mcp are the sites' own servers, built on their documented APIs.

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, except pasavard-mcp and swapwallet-mcp, which their sites host: you add them by URL, and sign in to SwapWallet once with OAuth. The site servers need no account and no API key. payping-mcp and bale-mcp work on your own account with your token, and swapwallet-mcp with your SwapWallet sign-in.

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/iran-mcp
claude plugin install digikala@iran-mcp            # one server
claude plugin install iran-travel@iran-mcp         # a bundle: food, shopping, cars, travel, maps, jobs, ...
claude plugin install iran-all@iran-mcp            # every read-only site server

claude plugin install <name> --marketplace sepehr071/iran-mcp does both steps in one command. payping, bale and swapwallet act on your own account, so no bundle includes them; install them by name. SwapWallet also publishes this server as its own plugin (swapwallet@swapwallet, from SwapWallet/swapwallet-mcp), with the same rules. Install one of the two: with both you get the server twice.

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/iran-mcp

Grok Build reads the same marketplace: grok plugin marketplace add sepehr071/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
claude mcp add --transport http swapwallet https://swapwallet.app/mcp   # hosted; then sign in from /mcp
claude mcp add --transport http pasavard https://pasavard.ir/api/mcp      # hosted, no sign-in

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

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

swapwallet-mcp is added by URL, and each client takes a URL in its own shape (Windsurf uses serverUrl, Claude Desktop takes it under Settings → Connectors): see its setup for each client.

All 77 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/iran-mcp
cd iran-mcp && claude

[!TIP] 994 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
baneh-mcp	Baneh	7			Appliances, TVs and electronics: cheapest in-stock price, brands, reviews
torob-mcp	Torob (price comparison)	26			Every shop's price for a product, price history, deal checks, installments, cheapest shop for a basket
basalam-mcp	Basalam (marketplace)	7			Goods from thousands of small shops: price, shipping and discount filters, cheapest offers, shop ratings, reviews
shopino-mcp	Shopino	14			Fashion from thousands of shops: prices, sizes, stock, shop ratings
banimode-mcp	Banimode	7			Fashion: prices, sizes, stock, brands, deals, reviews
pasavard-mcp	Pasavard (official, hosted)	4			Digikala and Snappshop prices tracked hourly: best picks per budget against each product's 30-day low, with affiliate and cashback links
emalls-ir-mcp	Emalls (price comparison)	10			Products across Iranian shops, every shop's offer, price history, shops
mobile-ir-mcp	Mobile.ir	17			Phone specs, shop prices, price history, used phones, SIM numbers
zoomit-mcp	Zoomit (Zoobin)	12			Phone, laptop and GPU specs, shop prices, price history, comparisons, reviews
snappshop-mcp	Snapp! Shop	13			Marketplace search, categories, every seller's offer in Toman, reviews, flash sales

🏠 Classifieds

Server	Site	Tools	Version	Updated	What your agent can do
divar-mcp	Divar	31			Homes, cars, phones and more in any city: cheapest and best-value ads, fair-price check, market stats, new-ad alerts
sheypoor-mcp	Sheypoor	11			Ads in any city, ad details, price summaries for cars and homes, shops

🚗 Cars

Server	Site	Tools	Version	Updated	What your agent can do
bama-ir-mcp	Bama	12			Car ads, market prices, new-car price lists, dealers, specs
karnameh-mcp	Karnameh	15			Used-car ads, specs and comparisons, new-car market prices and price history
hamrah-mechanic-mcp	Hamrah Mechanic	12			Daily car prices, price estimates, used cars for sale, inspection fees

💄 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
tapsifood-mcp	Tapsi Food	11			Dishes and restaurants near you, menus, flash deals, discounted restaurants, reviews

✈️ 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, Jabama Tours, Jabama Events	21			Stays with exact prices, group tours, events and theater tickets
otaghak-mcp	Otaghak	15			Villas and cottages: availability, exact stay price, reviews, hosts
alibaba-ir-mcp	Alibaba	14			Cheapest domestic and international flights, trains, buses, hotels, villas and tours
eghamat24-mcp	Eghamat24	14			Hotels: room prices for your dates, price calendar, deals, reviews, tours

🗺️ Maps

Server	Site	Tools	Version	Updated	What your agent can do
neshan-mcp	Neshan	11			Place search, reviews, nearby places, reverse geocoding, air quality, car, bike, walking and transit directions, traffic-zone checks
balad-mcp	Balad	9			Places and addresses, nearby and nearest by driving time, places along a route, hours, reviews, driving directions with live traffic

🩺 Health

Server	Site	Tools	Version	Updated	What your agent can do
paziresh24-mcp	Paziresh24	12

…