
19 open-source MCP servers (308 tools) that give AI agents the Iranian web: Digikala, Snappfood
19 open-source MCP servers (308 tools) that give AI agents the Iranian web: Digikala, Snappfood, Jabama, MrBilit, Paziresh24, Taaghche and more. Prices in Toman.
·
English · فارسی
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
iran-jobs is now the iran-jobs-mcp server; the jobs bundle is iran-jobs-bundle.Full list: CHANGELOG.md.
iran-cars, iran-maps, iran-jobs, iran-freelance, iran-economy, iran-stocks,
iran-classifieds, iran-learning and iran-law.Full list: CHANGELOG.md.
mkh_), iran-apps-mcp (Cafe Bazaar and Myket) and
iran-downloads-mcp (download-site search, item page only, never a
download link).iran-fashion and iran-software.Full list: CHANGELOG.md.
<NAME>_MCP_PROXY takes several proxies, separated by commas. When one is blocked, the next takes
over.<package>[browser].Full list: CHANGELOG.md.
Full list, including changes for callers: CHANGELOG.md.
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
mrbilitfor flights →jabamaandotaghakfor stays →paziresh24for 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
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 serverclaude 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-mcpGrok 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-inAny 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.
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| Server | Site | Tools | Version | Updated | What your agent can do |
|---|---|---|---|---|---|
| paziresh24-mcp | Paziresh24 | 12 | Doctors, visit prices, reviews, free appointment slots | ||
| doctoreto-mcp | Doctoreto | 14 | Doctors, visit fees, free slots, reviews, clinics, labs, offers | ||
| exiryab-mcp | ExirYab (official) | 3 | Find a doctor by name, city and specialty: profile, clinics, phones, hours, map location | ||
| darukade-mcp | Darukade (online pharmacy) | 12 | Pharmacy and care products: prices, cheapest, ingredients, usage, reviews |
| Server | Site | Tools | Version | Updated | What your agent can do |
|---|---|---|---|---|---|
| taaghche-mcp | Taaghche | 12 | Ebooks and audiobooks: prices, discounts, reviews, bestsellers, free books | ||
| fidibo-mcp | Fidibo | 11 | Ebooks and audiobooks: prices, Fidibo Plus, reviews, bestsellers, free books | ||
| 30book-mcp | 30book | 14 | Printed books: list and discounted price, stock, editions, ISBN, deals | ||
| iranketab-mcp | Iranketab | 13 | Printed books: translations and editions compared, ratings, reviews, prices |
| Server | Site | Tools | Version | Updated | What your agent can do |
|---|---|---|---|---|---|
| maktabkhooneh-mcp | Maktabkhooneh | 12 | Persian online courses: cheapest and free courses, deals, curriculum, teachers, reviews | ||
| iran-apps-mcp | Cafe Bazaar and Myket | 6 | Android apps: search, compare across both stores, top lists, similar apps | ||
| iran-downloads-mcp | Soft98, P30Download, Downloadly, VGDL | 4 | Metadata-only search of software and game download sites: returns the item page, never a download link | ||
| faradars-mcp | Faradars | 16 | Persian online courses: prices, syllabus, instructors, learning paths, offers |
| Server | Site | Tools | Version | Updated | What your agent can do |
|---|---|---|---|---|---|
| jobinja-mcp | Jobinja | 10 | Job search, ad details, companies, salary stats, skills in demand | ||
| jobvision-mcp | Jobvision | 14 | Job search, advertised pay, companies, interview reports, job market | ||
| irantalent-mcp | IranTalent | 11 | Job search, companies, employee reviews, salary reports | ||
| quera-mcp | Quera | 14 | Tech jobs, companies, salaries, contests, programming problems, courses and bootcamps | ||
| iran-jobs-mcp | IranTalent, Jobinja, Jobvision | 37 | Job ads, companies, reviews, interview reports and pay on three job sites side by side | ||
| ponisha-mcp | Ponisha | 14 | Freelance projects and bids, freelancers, services, skill demand | ||
| karlancer-mcp | Karlancer | 14 | Freelance projects, freelancers, services, market rates, trending skills |
| Server | Site | Tools | Version | Updated | What your agent can do |
|---|---|---|---|---|---|
| tsetmc-mcp | TSETMC | 8 | Tehran Stock Exchange quotes, movers, order book, history, indices, real versus legal trading (Rial) | ||
| codal-mcp | Codal | 5 | Listed companies' filings: financial statements, EPS, monthly activity reports as tables, meeting decisions (million Rial) | ||
| ifb-mcp | Iran Fara Bourse | 16 | Bond and sukuk yields, treasury bills, yield curve, IPOs, announcements, market stats (Rial) | ||
| fipiran-mcp | Fipiran | 11 | Mutual funds and ETFs: NAV, returns, size, managers, fund comparison | ||
| ime-mcp | Iran Mercantile Exchange | 14 | Commodity trades, supply offers, price history, market totals, options, deposit certificates (Rial) | ||
| iran-brokers-mcp | Mofid, Agah | 22 | Stocks, ETFs and funds, options, bonds and sukuk, gold and coin, screeners, Codal news, through two brokers (Rial) | ||
| cbi-mcp | Central Bank of Iran | 11 | Official exchange rates and their history, inflation, policy rates, liquidity, bond auctions, news (Rial) | ||
| amar-mcp | Statistical Centre of Iran | 12 | CPI inflation, unemployment, population, GDP, producer prices, release tables and calendar |
| Server | Site | Tools | Version | Updated | What your agent can do |
|---|---|---|---|---|---|
| tgju-mcp | TGJU | 6 | Live gold, coin, dollar, euro and crypto prices, market tables, daily history | ||
| iran-crypto-mcp | Nobitex, Wallex, Bitpin, Ramzinex, Tabdeal, OMPFinex, Exir | 12 | Compare a coin's price across 7 exchanges in Toman, order books, trades, candles, top movers | ||
| milligold-mcp | Milli.gold | 8 | Live 18k gold price per gram, history, fees and trade cost quotes, latest news and help articles, platform statistics | ||
| iran-gold-mcp | Milli.gold, Wallgold, Melligold, Daric, Taline | 3 | Compare the live 18k gold buy and sell price per gram on 5 platforms in Toman, cheapest to buy and best to sell, Milli.gold history | ||
| iran-news-mcp | Mehr, Khabaronline, Hamshahri, Tabnak, Entekhab, Asriran, Zoomit, Digiato, Varzesh3, Khabarvarzeshi | 6 | Latest headlines by source and category, keyword search, full article text | ||
| iran-quake-mcp | IRSC, USGS, EMSC | 5 | Latest and strongest earthquakes in Iran, history search, event detail, activity stats | ||
| qavanin-mcp | qavanin.ir | 7 | 168,000 laws, regulations and court votes: search, full text, one article, amendments, related documents | ||
| iran-tax-mcp | tax.gov.ir, stuffid.tax.gov.ir, regulation.tax.gov.ir | 6 | E-invoice goods/service IDs with VAT rate, activity codes, property transaction values, tax laws and circulars, official FAQ | ||
| iran-insurance-mcp | BimeBazar, Azki | 18 | Insurers and ratings, travel, third-party, car body, motorcycle, fire and health quotes side by side | ||
| rasmio-mcp | Rasmio | 8 | Iranian companies, board members, Official Gazette ads, products, brands, trademarks and patents (Rial) | ||
| varzesh3-mcp | Varzesh3 | 18 | Live scores, league tables, fixtures, teams, players, top scorers, transfers, TV schedule, news | ||
| gamefa-mcp | Gamefa | 13 | Game and film news, reviews with scores, game and film profiles, upcoming releases | ||
| iran-vod-mcp | Filimo, Namava | 13 | Films and series on Filimo and Namava: search, where to watch, title details, episodes, new releases, collections, plans | ||
| time-ir-mcp | Time.ir | 13 | Jalali, Gregorian and Hijri dates, holidays and long weekends, events, prayer times, qibla | ||
| rrk-mcp | Official Gazette (rrk.ir) | 5 | Laws, regulations and rulings published in the Official Gazette: search, latest, full text | ||
| iran-cloud-status-mcp | ArvanCloud, Hamravesh, Chabokan, Liara | 10 | Live status, incidents, planned maintenance, reliability, public prices compared |
| Server | Site | Tools | Version | Updated | What your agent can do |
|---|---|---|---|---|---|
| payping-mcp | PayPing | 21 | Read balance, sales, customers; create products, payment links, coupons, invoices | ||
| bale-mcp | Bale messenger | 13 | Read and answer your bot's messages, ask and wait for replies, send files | ||
| swapwallet-mcp | SwapWallet (official, hosted) | 13 | Read balances, P&L and history; request swaps, transfers and withdrawals that run only after you approve them in Telegram |
Every tool, with a one-line summary: TOOLS.md.
This repo is built to be read by agents as much as by people:
| File | What it is |
|---|---|
AGENTS.md | Which server to pick for which task, conventions, safety rules, how to work in this repo |
servers.json | Machine-readable catalog: package or URL, version, category, env vars and every tool of each server |
TOOLS.md | All 994 tools grouped by server, one line each |
llms.txt | Short index for LLMs (llmstxt.org) |
.mcp.json | Ready-to-use config for every server |
.claude-plugin/marketplace.json | The iran-mcp plugin marketplace: one plugin per server plus bundles |
plugins/ | Each plugin: its MCP server (a package pinned to a release, or a hosted server's URL) and a SKILL.md with when to use it and its rules |
PLUGINS.md | Agent compatibility, and how a server release reaches plugin users |
Paste this into your agent to set it up:
Read https://raw.githubusercontent.com/sepehr071/iran-mcp/main/AGENTS.md, then add the MCP servers I need for <task> to my MCP config.tsetmc-mcp, codal-mcp, ifb-mcp, ime-mcp, cbi-mcp and the NAV in fipiran-mcp. Their skills name the unit.payping-mcp and bale-mcp can write, but only to your own account, with your token, on your machine.
swapwallet-mcp works on your own SwapWallet account after you sign in, and a swap, transfer or withdrawal it asks
for runs only after you approve it in Telegram.image URL where the site has one.<NAME>_MCP_PROXY env var (e.g. DIGIKALA_MCP_PROXY) for sites
that block your IP. System proxy settings are ignored. See servers.json for exact names.src/<pkg>/http.py, registry.py, server.py, offline tests on recorded fixtures,
-m live tests against the real site, published to PyPI and the MCP Registry.Each server lives in its own repo and is pinned here as a git submodule under servers/. A hosted server's repo
holds its server.json and client configs, not its code; catalog.py reads its tools from the server card it
publishes.
git clone --recurse-submodules https://github.com/sepehr071/iran-mcp
cd iran-mcp/servers/digikala-mcp
uv sync && uv run pytest -q # offline tests
uv run pytest -m live -q # against the real sitePull every server to its latest main and rebuild the catalog:
git submodule update --init --remote
python scripts/catalog.py # rewrites servers.json, TOOLS.md, .mcp.json, plugins/, .claude-plugin/
python scripts/banner.py # redraws the banners with the new counts
claude plugin validate . # checks the marketplace and every pluginA nightly GitHub Action does all of this and commits the result. The full release flow is in PLUGINS.md.
Bugs and feature requests for a server go to that server's own repo.
All but three are unofficial and not affiliated with the sites. They call the same endpoints the sites' own web
apps use. Those APIs are undocumented and can change; open an issue on the server's repo when one breaks.
swapwallet-mcp is SwapWallet's own server, documented at swapwallet.app/docs/mcp.
exiryab-mcp is ExirYab's own server, on the public API listed in exiryab.com/llms.txt.
pasavard-mcp is Pasavard's own hosted server; its store links are affiliate links, and every result says so.
Some sites block foreign IPs. Set that server's proxy variable, e.g. DIGIKALA_MCP_PROXY=http://127.0.0.1:8080,
to a proxy with an Iranian exit.
Not on the sites: the site servers are read-only on purpose. Your agent finds and compares; you buy. The exception
is your own SwapWallet account: with swapwallet-mcp your agent can ask for a swap, transfer or withdrawal, and nothing
moves until you approve it in Telegram.
You need uv. uvx downloads the right Python and the
package on first run. pasavard-mcp and swapwallet-mcp run on their sites' servers and need nothing installed.
Plugins pin each package server to a release, so a plugin update is a server update. pasavard-mcp and swapwallet-mcp are hosted:
they change whenever their sites deploy them, and a plugin update only brings a new skill. Turn on auto-update once in
/plugin → Marketplaces → iran-mcp, or run claude plugin update <name>@iran-mcp. A plain
uvx digikala-mcp config keeps running its cached copy; run uvx digikala-mcp@latest --help once and restart
your client to upgrade it.
If this saves you some tab-hopping, a star on the repo helps other people find it.
Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites. If this repo saves you some tab-hopping, a star helps other people find it.
MIT. Each package server is MIT licensed in its own repo. Site names, logos and trademarks belong to their owners and are shown only to identify each site.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add jabama -- uvx jabama-mcp{
"mcpServers": {
"jabama": {
"args": [
"jabama-mcp"
],
"command": "uvx"
}
}
}code --add-mcp '{"name":"jabama","args":["jabama-mcp"],"command":"uvx"}'[mcp_servers.jabama]
command = "uvx"
args = ["jabama-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/iran-mcp-servers-awesome-iran-mcp to learn what the "Iran MCP servers: awesome-iran-mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx skills add sepehr071/iran-mcpclaude 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-inThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/iran-mcp-servers-awesome-iran-mcp)Nothing comparable is listed yet.
v2.4v2.4: 6 new servers, now 77Release notesv2.3v2.3: 31 new servers, now 71Release notesv2.0v2.0: 12 new servers, now 36Release notesv1.7v1.7: fewer blocks, and now on TorobRelease notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "iran-mcp-servers-awesome-iran-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.