iran-mcp
MCP servers and skills for Iranian websites: shopping, classifieds, cars, food, travel, maps, doctors, books, jobs, markets, crypto.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/sepehr071/iran-mcp with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/sepehr071/iran-mcp'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/sepehr071--iran-mcp)HTML
<a href="/listings/sepehr071--iran-mcp"><img src="/api/listings/sepehr071--iran-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Every server is a small Python package on PyPI, run with [`uvx`](https://docs.astral.sh/uv/), 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](https://github.com/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](PLUGINS.md#compatibility).
**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](https://github.com/SwapWallet/swapwallet-mcp#connect).
**All 77 at once:** clone this repo and open it in Claude Code. The [`.mcp.json`](.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.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 731 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "iran-mcp",
- "description": "MCP servers and skills for Iranian websites: shopping, classifieds, cars, food, travel, maps, doctors, books, jobs, markets, crypto.",
- "owner": {
- "name": "Sepehr Radmard",
- "email": "sepehrr80@gmail.com",
- "url": "https://github.com/sepehr071"
- },
- "plugins": [
- {
- "name": "snapp",
- "source": "./plugins/snapp",
- "description": "Unofficial read-only Snappfood & SnappMarket: search food and groceries, compare prices, deals.",
- "category": "food"
- },
- {
- "name": "okala",
- "source": "./plugins/okala",
- "description": "Unofficial read-only Okala: grocery stores that deliver to you, compare prices across stores.",
- "category": "food"
- },
- {
- "name": "tapsifood",
- "source": "./plugins/tapsifood",
- "description": "Unofficial read-only Tapsi Food: search dishes and restaurants, menus, reviews, flash deals.",
- "category": "food"
- },
- {
- "name": "digikala",
- "source": "./plugins/digikala",
- "description": "Unofficial read-only Digikala: search products, compare sellers, price history, reviews, deals.",
- "category": "shopping"
- },
- {
- "name": "technolife",
- "source": "./plugins/technolife",
- "description": "Unofficial read-only Technolife: search electronics, compare sellers and installment prices, deals.",
- "category": "shopping"
- },
- {
- "name": "masterkala",
- "source": "./plugins/masterkala",
- "description": "Unofficial read-only MasterKala: search gadgets, compare prices and specs, stock, delivery, deals.",
- "category": "shopping"
- },
- {
- "name": "baneh",
- "source": "./plugins/baneh",
- "description": "Unofficial read-only Baneh: search appliances, TVs, electronics, find the cheapest in-stock price.",
- "category": "shopping"
- },
- {
- "name": "torob",
- "source": "./plugins/torob",
- "description": "Unofficial read-only Torob: compare Iranian shop prices, price history, deal checks and baskets.",
- "category": "shopping"
- },
- {
- "name": "basalam",
- "source": "./plugins/basalam",
- "description": "Unofficial read-only Basalam marketplace: search products, cheapest offers, shops, reviews.",
- "category": "shopping"
- },
- {
- "name": "emalls-ir",
- "source": "./plugins/emalls-ir",
- "description": "Read-only Emalls (emalls.ir) price comparison: products, shop offers, price history, shops.",
- "category": "shopping"
- },
- {
- "name": "mobile-ir",
- "source": "./plugins/mobile-ir",
- "description": "Read-only Mobile.ir: phone specs, shop prices and history, used phones, numbered SIM cards.",
- "category": "shopping"
- },
- {
- "name": "zoomit",
- "source": "./plugins/zoomit",
- "description": "Read-only Zoomit (zoobin) product database: specs, shop prices in Toman, price history, comparisons.",
- "category": "shopping"
- },
- {
- "name": "snappshop",
- "source": "./plugins/snappshop",
- "description": "Read-only Snapp! Shop marketplace: search, categories, seller offers in Toman, reviews.",
- "category": "shopping"
- },
- {
- "name": "khanoumi",
- "source": "./plugins/khanoumi",
- "description": "Unofficial read-only Khanoumi: search cosmetics and skin care, compare prices, shades, reviews.",
- "category": "beauty"
- },
- {
- "name": "asalbanoo",
- "source": "./plugins/asalbanoo",
- "description": "Unofficial read-only Asal Banoo: search cosmetics and skin care, compare prices, sizes, deals.",
- "category": "beauty"
- },
- {
- "name": "shopino",
- "source": "./plugins/shopino",
- "description": "Unofficial read-only Shopino: search fashion across Iranian shops, compare prices, sizes, stock.",
- "category": "fashion"
- },
- {
- "name": "banimode",
- "source": "./plugins/banimode",
- "description": "Unofficial read-only Banimode: search fashion, compare prices, sizes, stock and flash deals.",
- "category": "fashion"
- },
- {
- "name": "digistyle",
- "source": "./plugins/digistyle",
- "description": "Read-only Digistyle (digistyle.com) fashion store: search, filters, product details, brands, deals.",
- "category": "fashion"
- },
- {
- "name": "divar",
- "source": "./plugins/divar",
- "description": "Unofficial read-only Divar: search Iran's classified ads, cheapest and best-value ads, price checks.",
- "category": "classifieds"
- },
- {
- "name": "sheypoor",
- "source": "./plugins/sheypoor",
- "description": "Read-only Sheypoor (sheypoor.com) classifieds: search ads, ad details, price summaries.",
- "category": "classifieds"
- },
- {
- "name": "kilid",
- "source": "./plugins/kilid",
- "description": "Read-only Kilid (kilid.com) Iranian real estate: listings, districts, price per m2, agencies.",
- "category": "classifieds"
- },
- {
- "name": "bama-ir",
- "source": "./plugins/bama-ir",
- "description": "Read-only Bama (bama.ir) Iran car marketplace: ad search, ad details, market prices, new-car prices.",
- "category": "cars"
- },
- {
- "name": "karnameh",
- "source": "./plugins/karnameh",
- "description": "Read-only Karnameh (karnameh.com) Iran car data: used ads, new-car prices, specs, comparisons, blog.",
- "category": "cars"
- },
- {
- "name": "hamrah-mechanic",
- "source": "./plugins/hamrah-mechanic",
- "description": "Read-only Hamrah Mechanic (hamrah-mechanic.com) car prices, used cars for sale, inspection fees.",
- "category": "cars"
- },
- {
- "name": "khodro45",
- "source": "./plugins/khodro45",
- "description": "Read-only Khodro45 (khodro45.com) Iran used cars: listings, inspection reports, price estimate.",
- "category": "cars"
- },
- {
- "name": "otaghak",
- "source": "./plugins/otaghak",
- "description": "Unofficial read-only Otaghak: search Iranian villas, availability, exact stay prices, reviews.",
- "category": "travel"
- },
- {
- "name": "jabama",
- "source": "./plugins/jabama",
- "description": "Unofficial read-only Jabama: villas and stays with exact prices, group tours, events and theater.",
- "category": "travel"
- },
- {
- "name": "mrbilit",
- "source": "./plugins/mrbilit",
- "description": "Unofficial read-only MrBilit: Iranian flights, trains, buses, taxis and hotels, seats and prices.",
- "category": "travel"
- },
- {
- "name": "flytoday",
- "source": "./plugins/flytoday",
- "description": "Unofficial read-only Flytoday: Iranian and international flights, hotels, villas, trains, buses.",
- "category": "travel"
- },
- {
- "name": "alibaba-ir",
- "source": "./plugins/alibaba-ir",
- "description": "Read-only Alibaba (alibaba.ir) Iran travel: trains, buses, flights, hotels, villas and tours.",
- "category": "travel"
- },
- {
- "name": "eghamat24",
- "source": "./plugins/eghamat24",
- "description": "Read-only Eghamat24 (eghamat24.com) Iran hotels: search, room prices, deals, reviews, facilities.",
- "category": "travel"
- },
- {
- "name": "snapptrip",
- "source": "./plugins/snapptrip",
- "description": "Read-only SnappTrip: Iranian hotel search, rooms, reviews, calendar prices and domestic flights.",
- "category": "travel"
- },
- {
- "name": "raja",
- "source": "./plugins/raja",
- "description": "Read-only Raja (raja.ir) Iranian trains: stations, search with prices and seats, timetables, news.",
- "category": "travel"
- },
- {
- "name": "iran-bus",
- "source": "./plugins/iran-bus",
- "description": "Read-only Iranian bus tickets (Safar724): trips, Toman prices, free seats, cheapest ticket.",
- "category": "travel"
- },
- {
- "name": "neshan",
- "source": "./plugins/neshan",
- "description": "Read-only Neshan map of Iran: places, reviews, photos, routes, travel times, zones, air quality.",
- "category": "maps"
- },
- {
- "name": "balad",
- "source": "./plugins/balad",
- "description": "Read-only Balad (balad.ir) Iran map: places nearby or on the way, details, reviews, driving routes.",
- "category": "maps"
- },
- {
- "name": "iran-roads",
- "source": "./plugins/iran-roads",
- "description": "Read-only Iran road status (141.ir): bulletins, closures, restrictions, road works, weather.",
- "category": "maps"
- },
- {
- "name": "paziresh24",
- "source": "./plugins/paziresh24",
- "description": "Unofficial read-only Paziresh24: find Iranian doctors, profiles, prices, reviews and free slots.",
- "category": "health"
- },
- {
- "name": "doctoreto",
- "source": "./plugins/doctoreto",
- "description": "Unofficial read-only Doctoreto: Iranian doctors, visit fees, free appointment times, clinics, labs.",
- "category": "health"
- },
- {
- "name": "exiryab",
- "source": "./plugins/exiryab",
- "description": "Official read-only ExirYab: find Iranian doctors by name, city and specialty, with clinics and maps.",
- "category": "health"
- },
- {
- "name": "darukade",
- "source": "./plugins/darukade",
- "description": "Read-only Darukade (darukade.com) pharmacy: products, prices, ingredients, usage, reviews.",
- "category": "health"
- },
- {
- "name": "taaghche",
- "source": "./plugins/taaghche",
- "description": "Unofficial read-only Taaghche: search Persian ebooks and audiobooks, compare prices, read reviews.",
- "category": "books"
- },
- {
- "name": "fidibo",
- "source": "./plugins/fidibo",
- "description": "Unofficial read-only Fidibo: search Persian ebooks and audiobooks, compare prices, free books.",
- "category": "books"
- },
- {
- "name": "30book",
- "source": "./plugins/30book",
- "description": "Unofficial read-only 30book: search Iranian printed books, compare editions and prices.",
- "category": "books"
- },
- {
- "name": "iranketab",
- "source": "./plugins/iranketab",
- "description": "Read-only Iranketab (iranketab.ir) books: search, translations compared, ratings, reviews, prices.",
- "category": "books"
- },
- {
- "name": "maktabkhooneh",
- "source": "./plugins/maktabkhooneh",
- "description": "Unofficial read-only Maktabkhooneh: search Persian online courses, compare prices, find free ones.",
- "category": "learning"
- },
- {
- "name": "faradars",
- "source": "./plugins/faradars",
- "description": "Read-only Faradars (faradars.org) courses: search, prices, syllabus, reviews, instructors, magazine.",
- "category": "learning"
- },
- {
- "name": "jobinja",
- "source": "./plugins/jobinja",
- "description": "Read-only Jobinja (jobinja.ir) job search, ad details, companies and top-50 scores for Iran.",
- "category": "jobs"
- },
- {
- "name": "jobvision",
- "source": "./plugins/jobvision",
- "description": "Read-only Jobvision (jobvision.ir) Iran jobs: search ads, job and company details, advertised pay.",
- "category": "jobs"
- },
- {
- "name": "irantalent",
- "source": "./plugins/irantalent",
- "description": "Read-only IranTalent (irantalent.com) job portal: search jobs, ad details, companies, reviews.",
- "category": "jobs"
- },
- {
- "name": "quera",
- "source": "./plugins/quera",
- "description": "Read-only Quera (quera.org): Iranian tech jobs, companies, contests, problems, courses and blog.",
- "category": "jobs"
- },
- {
- "name": "iran-jobs",
- "source": "./plugins/iran-jobs",
- "description": "Read-only Iran jobs: IranTalent, Jobinja, Jobvision side by side. Ads, companies, reviews, pay.",
- "category": "jobs"
- },
- {
- "name": "ponisha",
- "source": "./plugins/ponisha",
- "description": "Read-only Ponisha (ponisha.ir) freelance market: projects, bids, freelancers, skill demand.",
- "category": "freelance"
- },
- {
- "name": "karlancer",
- "source": "./plugins/karlancer",
- "description": "Read-only Karlancer (karlancer.com) freelance projects, freelancers and services in Iran.",
- "category": "freelance"
- },
- {
- "name": "iran-apps",
- "source": "./plugins/iran-apps",
- "description": "Unofficial read-only Cafe Bazaar and Myket: search apps, compare versions and ratings, top lists.",
- "category": "software"
- },
- {
- "name": "iran-downloads",
- "source": "./plugins/iran-downloads",
- "description": "Unofficial read-only metadata search of Soft98, P30Download, Downloadly and VGDL. Links only.",
- "category": "software"
- },
- {
- "name": "iran-cloud-status",
- "source": "./plugins/iran-cloud-status",
- "description": "Read-only status, incidents and prices of Iranian clouds: Arvan, Hamravesh, Chabokan, Liara, more.",
- "category": "cloud"
- },
- {
- "name": "tgju",
- "source": "./plugins/tgju",
- "description": "Unofficial read-only TGJU: live Iranian gold, coin, currency and crypto prices with daily history.",
- "category": "prices"
- },
- {
- "name": "iran-crypto",
- "source": "./plugins/iran-crypto",
- "description": "Unofficial read-only Iranian crypto exchanges: prices in Toman, order books, trades, candles.",
- "category": "prices"
- },
- {
- "name": "milligold",
- "source": "./plugins/milligold",
- "description": "Unofficial read-only Milli.gold: live 18k gold price, history, fees, trade quotes, news and help.",
- "category": "prices"
- },
- {
- "name": "iran-gold",
- "source": "./plugins/iran-gold",
- "description": "Read-only 18k gold prices on Iranian sites: Milli.gold, Wallgold, Melligold, Daric, Taline, Talano.",
- "category": "prices"
- },
- {
- "name": "tsetmc",
- "source": "./plugins/tsetmc",
- "description": "Unofficial read-only Tehran Stock Exchange (TSETMC): quotes, movers, order book, history, indices.",
- "category": "stocks"
- },
- {
- "name": "codal",
- "source": "./plugins/codal",
- "description": "Read-only codal.ir: search disclosures of Iranian listed companies, read letters and statements.",
- "category": "stocks"
- },
- {
- "name": "ifb",
- "source": "./plugins/ifb",
- "description": "Read-only Iran Fara Bourse (ifb.ir): bond, sukuk and treasury yields, IPOs, notices, market stats.",
- "category": "stocks"
- },
- {
- "name": "fipiran",
- "source": "./plugins/fipiran",
- "description": "Read-only Fipiran (fipiran.ir) data on Iranian mutual funds and ETFs: NAV, returns, size, managers.",
- "category": "stocks"
- },
- {
- "name": "ime",
- "source": "./plugins/ime",
- "description": "Read-only Iran Mercantile Exchange (ime.co.ir): physical trades, supply, prices, market totals.",
- "category": "stocks"
- },
- {
- "name": "iran-brokers",
- "source": "./plugins/iran-brokers",
- "description": "Read-only Iran broker data from Mofid and Agah: stocks, funds, options, bonds, gold, education.",
- "category": "stocks"
- },
- {
- "name": "cbi",
- "source": "./plugins/cbi",
- "description": "Read-only Central Bank of Iran (cbi.ir): official FX rates, inflation, policy rates, news.",
- "category": "economy"
- },
- {
- "name": "amar",
- "source": "./plugins/amar",
- "description": "Read-only Statistical Centre of Iran (amar.org.ir): CPI inflation, unemployment, census, any table.",
- "category": "economy"
- },
- {
- "name": "iran-news",
- "source": "./plugins/iran-news",
- "description": "Unofficial read-only Persian news RSS: Mehr, Tabnak, Entekhab, Zoomit, Varzesh3, more.",
- "category": "news"
- },
- {
- "name": "digiato",
- "source": "./plugins/digiato",
- "description": "Read-only Digiato tech news: latest, by category, search, full articles, reviews and tags.",
- "category": "news"
- },
- {
- "name": "varzesh3",
- "source": "./plugins/varzesh3",
- "description": "Read-only Varzesh3 (varzesh3.com) Iranian sports: live scores, tables, fixtures, teams, news.",
- "category": "sports"
- },
- {
- "name": "gamefa",
- "source": "./plugins/gamefa",
- "description": "Read-only Gamefa (gamefa.com) Persian game and film site: news, scored reviews, profiles, releases.",
- "category": "entertainment"
- },
- {
- "name": "iran-vod",
- "source": "./plugins/iran-vod",
- "description": "Read-only Filimo and Namava catalogs: search, title details, episodes, new, genres, where to watch.",
- "category": "video"
- },
- {
- "name": "aparat",
- "source": "./plugins/aparat",
- "description": "Read-only Aparat (aparat.com) Iranian video platform: search, videos, channels, trending, comments.",
- "category": "media"
- },
- {
- "name": "namasha",
- "source": "./plugins/namasha",
- "description": "Read-only Namasha (namasha.com) Iranian video platform: search, videos, channels, categories.",
- "category": "media"
- },
- {
- "name": "telewebion",
- "source": "./plugins/telewebion",
- "description": "Read-only Telewebion (telewebion.ir) IRIB TV: channels, what aired, programs, episodes, live sports.",
- "category": "media"
- },
- {
- "name": "iranseda",
- "source": "./plugins/iranseda",
- "description": "Read-only Iranseda (IRIB audio): radio channels, live streams, schedules, audiobooks, music, Quran.",
- "category": "media"
- },
- {
- "name": "cinematicket",
- "source": "./plugins/cinematicket",
- "description": "Read-only Cinematicket (cinematicket.org): cinemas, films, showtimes, prices, theatre, box office.",
- "category": "events"
- },
- {
- "name": "tiwall",
- "source": "./plugins/tiwall",
- "description": "Read-only Tiwall (tiwall.com) Iranian event tickets: theatre, concerts, venues, sessions, prices.",
- "category": "events"
- },
- {
- "name": "time-ir",
- "source": "./plugins/time-ir",
- "description": "Read-only Time.ir Iranian calendar: Jalali/Gregorian/Hijri dates, holidays, events, prayer times.",
- "category": "calendar"
- },
- {
- "name": "iran-quake",
- "source": "./plugins/iran-quake",
- "description": "Unofficial read-only Iran earthquakes: latest, search, strongest, detail, stats (USGS, EMSC, IRSC).",
- "category": "quakes"
- },
- {
- "name": "iran-weather",
- "source": "./plugins/iran-weather",
- "description": "Read-only Iran Meteorological Org (irimo.ir): city forecasts, observations, warnings.",
- "category": "weather"
- },
- {
- "name": "qavanin",
- "source": "./plugins/qavanin",
- "description": "Unofficial read-only qavanin.ir: search Iranian laws and regulations, read full text and status.",
- "category": "law"
- },
- {
- "name": "rrk",
- "source": "./plugins/rrk",
- "description": "Read-only Official Gazette of Iran (rrk.ir): search laws and rulings, read their text.",
- "category": "law"
- },
- {
- "name": "iran-tax",
- "source": "./plugins/iran-tax",
- "description": "Unofficial read-only Iranian tax: goods IDs and VAT, activity codes, property values, tax laws.",
- "category": "tax"
- },
- {
- "name": "iran-insurance",
- "source": "./plugins/iran-insurance",
- "description": "Read-only Iran insurance: BimeBazar and Azki side by side. Quotes, ratings, travel prices, guides.",
- "category": "insurance"
- },
- {
- "name": "rasmio",
- "source": "./plugins/rasmio",
- "description": "Read-only Rasmio (rasmio.com): Iranian companies, board members, gazette ads, products, brands.",
- "category": "companies"
- },
- {
- "name": "iran-dictionary",
- "source": "./plugins/iran-dictionary",
- "description": "Read-only Persian dictionaries: Abadis and Vajehyab. Meanings, synonyms, translation, names.",
- "category": "reference"
- },
- {
- "name": "persian-wikipedia",
- "source": "./plugins/persian-wikipedia",
- "description": "Read-only Persian Wikipedia (fa.wikipedia.org): search, summaries, article text, nearby places.",
- "category": "reference"
- },
- {
- "name": "virgool",
- "source": "./plugins/virgool",
- "description": "Read-only Virgool (virgool.ir) Persian blog platform: search, posts, authors, topics, publications.",
- "category": "community"
- },
- {
- "name": "ninisite",
- "source": "./plugins/ninisite",
- "description": "Read-only Ninisite (ninisite.com) parenting forum topics, articles and pregnancy weeks.",
- "category": "community"
- },
- {
- "name": "payping",
- "source": "./plugins/payping",
- "description": "PayPing merchant account for agents: balance, sales, invoices; create invoices and payment links.",
- "category": "business"
- },
- {
- "name": "bale",
- "source": "./plugins/bale",
- "description": "Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.",
- "category": "messaging"
- },
- {
- "name": "pasavard",
- "source": "./plugins/pasavard",
- "description": "Pasavard: hourly-tracked Digikala/Snappshop price lists by category and budget, with cashback links. Read-only.",
- "category": "shopping"
- },
- {
- "name": "swapwallet",
- "source": "./plugins/swapwallet",
- "description": "Crypto wallet: balances, P&L, history. Swaps, transfers and withdrawals need Telegram approval.",
- "category": "crypto"
- },
- {
- "name": "iran-all",
- "source": "./plugins/iran-all",
- "description": "All 93 Iranian site servers that need no setup, in one install.",
- "category": "bundle"
- },
- {
- "name": "iran-food",
- "source": "./plugins/iran-food",
- "description": "Everything for food or groceries delivered in Iran: Snappfood & SnappMarket, Okala, Tapsi Food.",
- "category": "bundle"
- },
- {
- "name": "iran-shopping",
- "source": "./plugins/iran-shopping",
- "description": "Everything for electronics, appliances or other goods in Iran: Digikala, Technolife, MasterKala, Baneh, Torob, Basalam, Emalls Price Comparison, Mobile.ir Phones, Zoomit Products, Snapp! Shop, Pasavard.",
- "category": "bundle"
- },
- {
- "name": "iran-beauty",
- "source": "./plugins/iran-beauty",
- "description": "Everything for cosmetics, skin and hair care or perfume in Iran: Khanoumi, Asal Banoo.",
- "category": "bundle"
- },
- {
- "name": "iran-fashion",
- "source": "./plugins/iran-fashion",
- "description": "Everything for clothes, shoes or bags in Iran: Shopino, Banimode, Digistyle Fashion.",
- "category": "bundle"
- },
- {
- "name": "iran-classifieds",
- "source": "./plugins/iran-classifieds",
- "description": "Everything for classified ads for homes, cars, phones and more in Iran: Divar, Sheypoor Classifieds, Kilid Real Estate.",
- "category": "bundle"
- },
- {
- "name": "iran-cars",
- "source": "./plugins/iran-cars",
- "description": "Everything for used or new car ads and prices in Iran: Bama Cars, Karnameh Cars, Hamrah Mechanic Cars, Khodro45 Used Cars.",
- "category": "bundle"
- },
- {
- "name": "iran-travel",
- "source": "./plugins/iran-travel",
- "description": "Everything for flights, trains, buses, hotels, villas or tours in Iran: Otaghak, Jabama, MrBilit, Flytoday, Alibaba Travel, Eghamat24 Hotels, SnappTrip Hotels and Flights, Raja Train Tickets, Iran Bus Tickets.",
- "category": "bundle"
- },
- {
- "name": "iran-maps",
- "source": "./plugins/iran-maps",
- "description": "Everything for places, addresses, routes, travel times or road closures in Iran: Neshan Maps, Balad Maps, Iran Roads.",
- "category": "bundle"
- },
- {
- "name": "iran-health",
- "source": "./plugins/iran-health",
- "description": "Everything for doctors, clinics, labs, appointments or pharmacy products in Iran: Paziresh24, Doctoreto, ExirYab, Darukade Pharmacy.",
- "category": "bundle"
- },
- {
- "name": "iran-books",
- "source": "./plugins/iran-books",
- "description": "Everything for ebooks, audiobooks or printed books in Iran: Taaghche, Fidibo, 30book, Iranketab Books.",
- "category": "bundle"
- },
- {
- "name": "iran-learning",
- "source": "./plugins/iran-learning",
- "description": "Everything for online courses, lessons or certificates in Iran: Maktabkhooneh, Faradars Courses.",
- "category": "bundle"
- },
- {
- "name": "iran-jobs-bundle",
- "source": "./plugins/iran-jobs-bundle",
- "description": "Everything for job ads, employers or salaries in Iran: Jobinja Jobs, Jobvision Jobs, IranTalent Jobs, Quera, Iran Jobs (IranTalent + Jobinja + Jobvision).",
- "category": "bundle"
- },
- {
- "name": "iran-freelance",
- "source": "./plugins/iran-freelance",
- "description": "Everything for freelance projects, freelancers or services in Iran: Ponisha Freelance, Karlancer Freelance.",
- "category": "bundle"
- },
- {
- "name": "iran-software",
- "source": "./plugins/iran-software",
- "description": "Everything for Android apps or software and game download listings in Iran: Iran Apps, Iran Software Downloads.",
- "category": "bundle"
- },
- {
- "name": "iran-prices",
- "source": "./plugins/iran-prices",
- "description": "Everything for live gold, coin, currency or crypto prices in Iran: TGJU Prices, Iran Crypto Exchanges, Milli.gold Prices, Iran Gold Prices.",
- "category": "bundle"
- },
- {
- "name": "iran-stocks",
- "source": "./plugins/iran-stocks",
- "description": "Everything for stock exchange quotes, company filings, funds, bonds or commodity exchange trades in Iran: TSETMC Tehran Stock Exchange, Codal (کدال) Disclosures, Iran Fara Bourse, Fipiran Funds, Iran Mercantile Exchange, Iran Brokers Market Data.",
- "category": "bundle"
- },
- {
- "name": "iran-economy",
- "source": "./plugins/iran-economy",
- "description": "Everything for official exchange rates, inflation, unemployment or other economic statistics in Iran: Central Bank of Iran, Statistical Centre of Iran.",
- "category": "bundle"
- },
- {
- "name": "iran-news-bundle",
- "source": "./plugins/iran-news-bundle",
- "description": "Everything for news headlines or full news articles in Iran: Iran News RSS, Digiato Tech News.",
- "category": "bundle"
- },
- {
- "name": "iran-media",
- "source": "./plugins/iran-media",
- "description": "Everything for online videos, TV channels and schedules or radio and audio archives in Iran: Aparat Videos, Namasha Videos, Telewebion TV, Iranseda Radio Archive.",
- "category": "bundle"
- },
- {
- "name": "iran-events",
- "source": "./plugins/iran-events",
- "description": "Everything for cinema showtimes or theatre, concert and event tickets in Iran: Cinematicket Tickets, Tiwall Events.",
- "category": "bundle"
- },
- {
- "name": "iran-law",
- "source": "./plugins/iran-law",
- "description": "Everything for laws, regulations, court votes, legal opinions or Official Gazette texts in Iran: Qavanin, Official Gazette of Iran.",
- "category": "bundle"
- },
- {
- "name": "iran-reference",
- "source": "./plugins/iran-reference",
- "description": "Everything for Persian word meanings, synonyms, translations or encyclopedia articles in Iran: Iran Dictionary (Abadis + Vajehyab), Persian Wikipedia.",
- "category": "bundle"
- },
- {
- "name": "iran-community",
- "source": "./plugins/iran-community",
- "description": "Everything for Persian blog posts, forum topics or parenting articles in Iran: Virgool Blog, Ninisite Parenting.",
- "category": "bundle"
- }
- ]
- }
README.md · README · 574 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <img src="assets/banner.svg" alt="iran-mcp: 96 MCP servers and 1150 tools for Iranian shopping, classifieds, car, food, travel, map, health, book, course, job, freelance, app, price, stock, insurance, company registry, economy, news, video, radio, cinema, weather, dictionary, sports, law, tax and crypto sites, for Claude, Cursor and Copilot" width="100%">
- **English** · [فارسی](README.fa.md)
- # Iran MCP servers: iran-mcp
- **Give your AI agent the Iranian web.**<br>
- 93 unofficial, open-source Persian-web MCP servers for Digikala, Torob, Divar, Snappfood, Jabama, MrBilit, Alibaba, Neshan, Balad, Paziresh24, Taaghche, Jobinja, Bama, Aparat, Raja, SnappTrip, Kilid, Persian Wikipedia, 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.<br>
- Search, compare prices in Toman, find free slots and today's deals from Claude, Cursor, GitHub Copilot in VS Code or any MCP client.<br>
- Install them as Claude Code plugins with skills, or as Agent Skills for Codex, Cursor, Antigravity and Grok Build.
- [](#the-servers)
- [](TOOLS.md)
- [](#quick-start)
- [](https://registry.modelcontextprotocol.io/?q=sepehr071)
- [](LICENSE)
- [](https://github.com/sepehr071/iran-mcp)
- Web catalog (in Persian): [mcpfarsi.ir](https://mcpfarsi.ir/), the Persian MCP marketplace.
- [What's new](#whats-new-in-v25) · [Quick start](#quick-start) · [The servers](#the-servers) · [For AI agents](#for-ai-agents) · [All tools](TOOLS.md) · [FAQ](#faq)
- </div>
- ---
- ## What's new in v2.5
- <img src="assets/release-v2.5.svg" alt="iran-mcp v2.5: 19 new servers, 5 new categories, 156 new tools, same tool names" width="100%">
- - **19 new servers**, all read-only and without sign-in: 96 servers and 1150 tools in total.
- - **Video, radio and TV (new category):** [aparat-mcp](https://github.com/sepehr071/aparat-mcp) and [namasha-mcp](https://github.com/sepehr071/namasha-mcp) (video platforms),
- [telewebion-mcp](https://github.com/sepehr071/telewebion-mcp) (TV channels and schedules) and [iranseda-mcp](https://github.com/sepehr071/iranseda-mcp) (radio, audiobooks, Quran).
- - **Cinema and events (new category):** [cinematicket-mcp](https://github.com/sepehr071/cinematicket-mcp) (showtimes and ticket prices, box office) and
- [tiwall-mcp](https://github.com/sepehr071/tiwall-mcp) (theatre and concert tickets).
- - **Travel, roads and weather (new category):** [snapptrip-mcp](https://github.com/sepehr071/snapptrip-mcp) (hotels and flights), [raja-mcp](https://github.com/sepehr071/raja-mcp) (trains),
- [iran-bus-mcp](https://github.com/sepehr071/iran-bus-mcp) (bus tickets), [iran-roads-mcp](https://github.com/sepehr071/iran-roads-mcp) (road closures and status) and [iran-weather-mcp](https://github.com/sepehr071/iran-weather-mcp) (forecasts and warnings).
- - **Homes, cars and fashion:** [kilid-mcp](https://github.com/sepehr071/kilid-mcp) (real estate and price per square metre), [khodro45-mcp](https://github.com/sepehr071/khodro45-mcp)
- (used cars with inspection reports) and [digistyle-mcp](https://github.com/sepehr071/digistyle-mcp) (fashion store).
- - **Dictionary, encyclopedia and community (new categories):** [iran-dictionary-mcp](https://github.com/sepehr071/iran-dictionary-mcp) (Abadis and Vajehyab),
- [persian-wikipedia-mcp](https://github.com/sepehr071/persian-wikipedia-mcp), [virgool-mcp](https://github.com/sepehr071/virgool-mcp) (Persian blogs) and [ninisite-mcp](https://github.com/sepehr071/ninisite-mcp) (parenting forum),
- plus [digiato-mcp](https://github.com/sepehr071/digiato-mcp) tech news.
- - **5 new bundles:** `iran-media`, `iran-events`, `iran-reference`, `iran-community` and `iran-news-bundle`.
- - **Every server updated** to its latest release. Tool names of the existing servers are unchanged.
- Full list: [CHANGELOG.md](CHANGELOG.md).
- <details>
- <summary><b>What's new in v2.4</b></summary>
- <img src="assets/release-v2.4.svg" alt="iran-mcp v2.4: 6 new servers, 3 new categories, 111 new tools, same tool names" width="100%">
- - **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](https://github.com/sepehr071/iran-insurance-mcp) (BimeBazar and Azki quotes and insurer
- ratings side by side) and [rasmio-mcp](https://github.com/sepehr071/rasmio-mcp) (the Rasmio company registry: board members, gazette ads, brands).
- - **Markets:** [iran-brokers-mcp](https://github.com/sepehr071/iran-brokers-mcp) (stocks, funds, options, bonds and screeners through brokers Mofid and Agah).
- - **Film and series (new category):** [iran-vod-mcp](https://github.com/sepehr071/iran-vod-mcp) (Filimo and Namava: where to watch, episodes, new releases).
- - **Shops and jobs:** [snappshop-mcp](https://github.com/sepehr071/snappshop-mcp) (Snapp! Shop seller offers and flash sales) and [iran-jobs-mcp](https://github.com/sepehr071/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](CHANGELOG.md).
- </details>
- <details>
- <summary><b>What's new in v2.3</b></summary>
- <img src="assets/release-v2.3.svg" alt="iran-mcp v2.3: 31 new servers, 9 new categories, 383 new tools, same tools and parameters" width="100%">
- - **31 new servers**, all read-only and without sign-in: 71 servers and 883 tools in total.
- - **Cars:** [bama-ir-mcp](https://github.com/sepehr071/bama-ir-mcp), [karnameh-mcp](https://github.com/sepehr071/karnameh-mcp)
- and [hamrah-mechanic-mcp](https://github.com/sepehr071/hamrah-mechanic-mcp) (car ads, daily and new-car prices),
- plus [sheypoor-mcp](https://github.com/sepehr071/sheypoor-mcp) classifieds.
- - **Maps and travel:** [neshan-mcp](https://github.com/sepehr071/neshan-mcp) and [balad-mcp](https://github.com/sepehr071/balad-mcp)
- (places, nearby search, directions with live traffic),
- [alibaba-ir-mcp](https://github.com/sepehr071/alibaba-ir-mcp) (flights, trains, buses, hotels, villas, tours) and
- [eghamat24-mcp](https://github.com/sepehr071/eghamat24-mcp) (hotels).
- - **Jobs and freelance:** [jobinja-mcp](https://github.com/sepehr071/jobinja-mcp),
- [jobvision-mcp](https://github.com/sepehr071/jobvision-mcp), [irantalent-mcp](https://github.com/sepehr071/irantalent-mcp),
- [quera-mcp](https://github.com/sepehr071/quera-mcp), [ponisha-mcp](https://github.com/sepehr071/ponisha-mcp) and
- [karlancer-mcp](https://github.com/sepehr071/karlancer-mcp).
- - **Markets and economy:** [codal-mcp](https://github.com/sepehr071/codal-mcp) (company filings),
- [ifb-mcp](https://github.com/sepehr071/ifb-mcp) (bonds and sukuk), [fipiran-mcp](https://github.com/sepehr071/fipiran-mcp)
- (funds), [ime-mcp](https://github.com/sepehr071/ime-mcp) (commodity exchange),
- [cbi-mcp](https://github.com/sepehr071/cbi-mcp) (Central Bank rates) and [amar-mcp](https://github.com/sepehr071/amar-mcp)
- (official statistics). Most of these quote Rial, and several answer only Iranian connections.
- - **Shops, books, courses and health:** [emalls-ir-mcp](https://github.com/sepehr071/emalls-ir-mcp),
- [mobile-ir-mcp](https://github.com/sepehr071/mobile-ir-mcp), [zoomit-mcp](https://github.com/sepehr071/zoomit-mcp),
- [iranketab-mcp](https://github.com/sepehr071/iranketab-mcp), [faradars-mcp](https://github.com/sepehr071/faradars-mcp)
- and [darukade-mcp](https://github.com/sepehr071/darukade-mcp) (online pharmacy).
- - **Sports, games, calendar and records:** [varzesh3-mcp](https://github.com/sepehr071/varzesh3-mcp),
- [gamefa-mcp](https://github.com/sepehr071/gamefa-mcp), [time-ir-mcp](https://github.com/sepehr071/time-ir-mcp),
- [rrk-mcp](https://github.com/sepehr071/rrk-mcp) (Official Gazette) and
- [iran-cloud-status-mcp](https://github.com/sepehr071/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](CHANGELOG.md).
- </details>
- <details>
- <summary><b>What's new in v2.0</b></summary>
- <img src="assets/release-v2.0.svg" alt="iran-mcp v2.0: 12 new servers, 7 new categories, 10 news sources, same tools and parameters" width="100%">
- - **12 new servers**, all read-only and without sign-in: 36 servers and 469 tools in total.
- - **Shops and food:** [basalam-mcp](https://github.com/sepehr071/basalam-mcp) (thousands of small shops),
- [banimode-mcp](https://github.com/sepehr071/banimode-mcp) (fashion),
- [baneh-mcp](https://github.com/sepehr071/baneh-mcp) (appliances, TVs, tools) and
- [tapsifood-mcp](https://github.com/sepehr071/tapsifood-mcp) (dishes and deals near an address).
- - **Prices, news and public records:** [tgju-mcp](https://github.com/sepehr071/tgju-mcp) (gold, coin, currency and
- crypto), [iran-news-mcp](https://github.com/sepehr071/iran-news-mcp) (10 news sources, plus a tech-news tool),
- [iran-quake-mcp](https://github.com/sepehr071/iran-quake-mcp) (earthquakes),
- [qavanin-mcp](https://github.com/sepehr071/qavanin-mcp) (national laws) and
- [iran-tax-mcp](https://github.com/sepehr071/iran-tax-mcp) (e-invoice IDs, VAT rates, tax rulings).
- - **Courses, apps and software:** [maktabkhooneh-mcp](https://github.com/sepehr071/maktabkhooneh-mcp) (its tools start
- with `mkh_`), [iran-apps-mcp](https://github.com/sepehr071/iran-apps-mcp) (Cafe Bazaar and Myket) and
- [iran-downloads-mcp](https://github.com/sepehr071/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](CHANGELOG.md).
- </details>
- <details>
- <summary><b>What's new in v1.7</b></summary>
- <img src="assets/release-v1.7.svg" alt="iran-mcp v1.7: fewer blocks, 100 Torob calls without a block, 18 steadier shop servers, 3 new servers, same tools and parameters" width="100%">
- - **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](https://github.com/sepehr071/torob-mcp)** (every Iranian shop's price for one product),
- **[pasavard-mcp](https://github.com/ashkancapella/pasavard-mcp)** (hosted, best buys per budget) and
- **[exiryab-mcp](https://github.com/sshnevis/exiryab-mcp)** (ExirYab's own doctor finder).
- - Tool names and parameters are unchanged.
- Full list: [CHANGELOG.md](CHANGELOG.md).
- </details>
- <details>
- <summary><b>What's new in v1.5</b></summary>
- <img src="assets/release-v1.5.svg" alt="iran-mcp v1.5: about 62% fewer tokens per tool call, a 19% smaller tool list, security hardening, and the new Divar server" width="100%">
- - **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](https://github.com/sepehr071/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](CHANGELOG.md).
- </details>
- ## 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`](https://docs.astral.sh/uv/), 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.
- ```bash
- 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](https://github.com/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.
- ```bash
- 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](PLUGINS.md#compatibility).
- **One server** (Claude Code, without the plugin):
- ```bash
- 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, ...):
- ```json
- {
- "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](https://github.com/SwapWallet/swapwallet-mcp#connect).
- **All 96 at once:** clone this repo and open it in Claude Code. The [`.mcp.json`](.mcp.json) at the root
- registers every server; approve the ones you want.
- ```bash
- git clone https://github.com/sepehr071/iran-mcp
- cd iran-mcp && claude
- ```
- > [!TIP]
- > 1150 tools is a lot of context. Enable the servers for the task at hand rather than all of them.
- ## Use them from the web: mcpfarsi.ir
- <p align="center"><a href="https://mcpfarsi.ir/"><b>mcpfarsi.ir</b></a>: the Persian marketplace of MCP servers and Agent Skills for Iranian services</p>
- Don't want to install anything? [**mcpfarsi.ir**](https://mcpfarsi.ir/) lists these servers and many more in Persian,
- with search and filters. Each entry says whether it uses an unofficial API, needs an Iranian IP or has side effects.
- Its hosted MCP router connects them to Claude, ChatGPT or Cursor: add one URL to your AI app once, sign in with OAuth,
- then pick servers in the dashboard. The router gives your agent two tools, `search_tools` and `call_tool`, so its
- context stays small however many servers you turn on.
- > [!TIP]
- > Running servers locally with `uvx` (above) and using mcpfarsi.ir work side by side. Use the site to find a
- > server, or to give an agent many Iranian services without adding each one by hand.
- ## The servers
- ### 🛒 Shopping
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [digikala-mcp](https://github.com/sepehr071/digikala-mcp) | [Digikala](https://www.digikala.com) (incl. Fresh) | 23 | [](https://pypi.org/project/digikala-mcp/) | [](https://github.com/sepehr071/digikala-mcp/commits/main) | Search with feature filters, best picks for a budget, every seller, price history, reviews, deals |
- | [technolife-mcp](https://github.com/sepehr071/technolife-mcp) | [Technolife](https://www.technolife.com) | 19 | [](https://pypi.org/project/technolife-mcp/) | [](https://github.com/sepehr071/technolife-mcp/commits/main) | Electronics: each seller's cash and installment price, specs, reviews, deals |
- | [masterkala-mcp](https://github.com/sepehr071/masterkala-mcp) | [MasterKala](https://masterkala.com) | 14 | [](https://pypi.org/project/masterkala-mcp/) | [](https://github.com/sepehr071/masterkala-mcp/commits/main) | Gadgets and accessories: prices, specs, deals |
- | [baneh-mcp](https://github.com/sepehr071/baneh-mcp) | [Baneh](https://baaneeh.com) | 7 | [](https://pypi.org/project/baneh-mcp/) | [](https://github.com/sepehr071/baneh-mcp/commits/main) | Appliances, TVs and electronics: cheapest in-stock price, brands, reviews |
- | [torob-mcp](https://github.com/sepehr071/torob-mcp) | [Torob](https://torob.com) (price comparison) | 26 | [](https://pypi.org/project/torob-mcp/) | [](https://github.com/sepehr071/torob-mcp/commits/main) | Every shop's price for a product, price history, deal checks, installments, cheapest shop for a basket |
- | [basalam-mcp](https://github.com/sepehr071/basalam-mcp) | [Basalam](https://basalam.com) (marketplace) | 7 | [](https://pypi.org/project/basalam-mcp/) | [](https://github.com/sepehr071/basalam-mcp/commits/main) | Goods from thousands of small shops: price, shipping and discount filters, cheapest offers, shop ratings, reviews |
- | [shopino-mcp](https://github.com/sepehr071/shopino-mcp) | [Shopino](https://shopino.app) | 14 | [](https://pypi.org/project/shopino-mcp/) | [](https://github.com/sepehr071/shopino-mcp/commits/main) | Fashion from thousands of shops: prices, sizes, stock, shop ratings |
- | [banimode-mcp](https://github.com/sepehr071/banimode-mcp) | [Banimode](https://www.banimode.com) | 7 | [](https://pypi.org/project/banimode-mcp/) | [](https://github.com/sepehr071/banimode-mcp/commits/main) | Fashion: prices, sizes, stock, brands, deals, reviews |
- | [digistyle-mcp](https://github.com/sepehr071/digistyle-mcp) | [Digistyle](https://www.digistyle.com) | 6 | [](https://pypi.org/project/digistyle-mcp/) | [](https://github.com/sepehr071/digistyle-mcp/commits/main) | Fashion: search with filters, product details, brands, deals |
- | [pasavard-mcp](https://github.com/ashkancapella/pasavard-mcp) | [Pasavard](https://pasavard.ir) (official, hosted) | 4 | [](https://github.com/ashkancapella/pasavard-mcp/blob/main/server.json) | [](https://github.com/ashkancapella/pasavard-mcp/commits/main) | 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](https://github.com/sepehr071/emalls-ir-mcp) | [Emalls](https://emalls.ir) (price comparison) | 10 | [](https://pypi.org/project/emalls-ir-mcp/) | [](https://github.com/sepehr071/emalls-ir-mcp/commits/main) | Products across Iranian shops, every shop's offer, price history, shops |
- | [mobile-ir-mcp](https://github.com/sepehr071/mobile-ir-mcp) | [Mobile.ir](https://www.mobile.ir) | 17 | [](https://pypi.org/project/mobile-ir-mcp/) | [](https://github.com/sepehr071/mobile-ir-mcp/commits/main) | Phone specs, shop prices, price history, used phones, SIM numbers |
- | [zoomit-mcp](https://github.com/sepehr071/zoomit-mcp) | [Zoomit](https://www.zoomit.ir/product) (Zoobin) | 12 | [](https://pypi.org/project/zoomit-mcp/) | [](https://github.com/sepehr071/zoomit-mcp/commits/main) | Phone, laptop and GPU specs, shop prices, price history, comparisons, reviews |
- | [snappshop-mcp](https://github.com/sepehr071/snappshop-mcp) | [Snapp! Shop](https://snappshop.ir) | 13 | [](https://pypi.org/project/snappshop-mcp/) | [](https://github.com/sepehr071/snappshop-mcp/commits/main) | 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](https://github.com/sepehr071/divar-mcp) | [Divar](https://divar.ir) | 31 | [](https://pypi.org/project/divar-mcp/) | [](https://github.com/sepehr071/divar-mcp/commits/main) | Homes, cars, phones and more in any city: cheapest and best-value ads, fair-price check, market stats, new-ad alerts |
- | [sheypoor-mcp](https://github.com/sepehr071/sheypoor-mcp) | [Sheypoor](https://www.sheypoor.com) | 11 | [](https://pypi.org/project/sheypoor-mcp/) | [](https://github.com/sepehr071/sheypoor-mcp/commits/main) | Ads in any city, ad details, price summaries for cars and homes, shops |
- | [kilid-mcp](https://github.com/sepehr071/kilid-mcp) | [Kilid](https://kilid.com) | 8 | [](https://pypi.org/project/kilid-mcp/) | [](https://github.com/sepehr071/kilid-mcp/commits/main) | Homes for sale and rent, districts, price per square metre, agencies |
- ### 🚗 Cars
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [bama-ir-mcp](https://github.com/sepehr071/bama-ir-mcp) | [Bama](https://bama.ir) | 12 | [](https://pypi.org/project/bama-ir-mcp/) | [](https://github.com/sepehr071/bama-ir-mcp/commits/main) | Car ads, market prices, new-car price lists, dealers, specs |
- | [karnameh-mcp](https://github.com/sepehr071/karnameh-mcp) | [Karnameh](https://karnameh.com) | 15 | [](https://pypi.org/project/karnameh-mcp/) | [](https://github.com/sepehr071/karnameh-mcp/commits/main) | Used-car ads, specs and comparisons, new-car market prices and price history |
- | [hamrah-mechanic-mcp](https://github.com/sepehr071/hamrah-mechanic-mcp) | [Hamrah Mechanic](https://www.hamrah-mechanic.com) | 12 | [](https://pypi.org/project/hamrah-mechanic-mcp/) | [](https://github.com/sepehr071/hamrah-mechanic-mcp/commits/main) | Daily car prices, price estimates, used cars for sale, inspection fees |
- | [khodro45-mcp](https://github.com/sepehr071/khodro45-mcp) | [Khodro45](https://khodro45.com) | 10 | [](https://pypi.org/project/khodro45-mcp/) | [](https://github.com/sepehr071/khodro45-mcp/commits/main) | Used cars with inspection reports, price estimate, deals, new-car prices |
- ### 💄 Beauty
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [khanoumi-mcp](https://github.com/sepehr071/khanoumi-mcp) | [Khanoumi](https://www.khanoumi.com) | 12 | [](https://pypi.org/project/khanoumi-mcp/) | [](https://github.com/sepehr071/khanoumi-mcp/commits/main) | Cosmetics, skin and hair care, perfume: prices, shades, reviews, deals |
- | [asalbanoo-mcp](https://github.com/sepehr071/asalbanoo-mcp) | [Asal Banoo](https://asalbanooshop.com) | 12 | [](https://pypi.org/project/asalbanoo-mcp/) | [](https://github.com/sepehr071/asalbanoo-mcp/commits/main) | Cosmetics and hair care: prices, variants, deals |
- ### 🍕 Food and groceries
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [snapp-mcp](https://github.com/sepehr071/snapp-mcp) | [Snappfood](https://snappfood.ir) + [SnappMarket](https://snapp.market) | 21 | [](https://pypi.org/project/snapp-mcp/) | [](https://github.com/sepehr071/snapp-mcp/commits/main) | Cheapest dish near you, menus, FoodParty flash deals, groceries |
- | [okala-mcp](https://github.com/sepehr071/okala-mcp) | [Okala](https://okala.com) | 16 | [](https://pypi.org/project/okala-mcp/) | [](https://github.com/sepehr071/okala-mcp/commits/main) | Grocery stores that deliver to you, prices across stores, deals |
- | [tapsifood-mcp](https://github.com/sepehr071/tapsifood-mcp) | [Tapsi Food](https://tapsi.food) | 11 | [](https://pypi.org/project/tapsifood-mcp/) | [](https://github.com/sepehr071/tapsifood-mcp/commits/main) | 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](https://github.com/sepehr071/mrbilit-mcp) | [MrBilit](https://mrbilit.com) | 22 | [](https://pypi.org/project/mrbilit-mcp/) | [](https://github.com/sepehr071/mrbilit-mcp/commits/main) | Cheapest flights, trains, buses, taxis and hotels; seats and refund rules |
- | [flytoday-mcp](https://github.com/sepehr071/flytoday-mcp) | [Flytoday](https://www.flytoday.ir) | 22 | [](https://pypi.org/project/flytoday-mcp/) | [](https://github.com/sepehr071/flytoday-mcp/commits/main) | Flights, trains, buses, hotels, villas; CIP, eSIM, visas, activities |
- | [jabama-mcp](https://github.com/sepehr071/jabama-mcp) | [Jabama](https://www.jabama.com), [Jabama Tours](https://jabama.tours), [Jabama Events](https://jabama.events) | 21 | [](https://pypi.org/project/jabama-mcp/) | [](https://github.com/sepehr071/jabama-mcp/commits/main) | Stays with exact prices, group tours, events and theater tickets |
- | [otaghak-mcp](https://github.com/sepehr071/otaghak-mcp) | [Otaghak](https://www.otaghak.com) | 15 | [](https://pypi.org/project/otaghak-mcp/) | [](https://github.com/sepehr071/otaghak-mcp/commits/main) | Villas and cottages: availability, exact stay price, reviews, hosts |
- | [alibaba-ir-mcp](https://github.com/sepehr071/alibaba-ir-mcp) | [Alibaba](https://www.alibaba.ir) | 14 | [](https://pypi.org/project/alibaba-ir-mcp/) | [](https://github.com/sepehr071/alibaba-ir-mcp/commits/main) | Cheapest domestic and international flights, trains, buses, hotels, villas and tours |
- | [eghamat24-mcp](https://github.com/sepehr071/eghamat24-mcp) | [Eghamat24](https://www.eghamat24.com) | 14 | [](https://pypi.org/project/eghamat24-mcp/) | [](https://github.com/sepehr071/eghamat24-mcp/commits/main) | Hotels: room prices for your dates, price calendar, deals, reviews, tours |
- | [snapptrip-mcp](https://github.com/sepehr071/snapptrip-mcp) | [SnappTrip](https://www.snapptrip.com) | 10 | [](https://pypi.org/project/snapptrip-mcp/) | [](https://github.com/sepehr071/snapptrip-mcp/commits/main) | Hotels: search, rooms, price calendar, reviews; domestic flights and fares |
- | [raja-mcp](https://github.com/sepehr071/raja-mcp) | [Raja](https://www.raja.ir) | 5 | [](https://pypi.org/project/raja-mcp/) | [](https://github.com/sepehr071/raja-mcp/commits/main) | Trains: stations, search with prices and free seats, stops and timetables, announcements |
- | [iran-bus-mcp](https://github.com/sepehr071/iran-bus-mcp) | [Safar724](https://safar724.com) | 5 | [](https://pypi.org/project/iran-bus-mcp/) | [](https://github.com/sepehr071/iran-bus-mcp/commits/main) | Bus trips with Toman prices and free seats, the cheapest ticket, terminals |
- ### 🗺️ Maps, roads and weather
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [neshan-mcp](https://github.com/sepehr071/neshan-mcp) | [Neshan](https://neshan.org) | 11 | [](https://pypi.org/project/neshan-mcp/) | [](https://github.com/sepehr071/neshan-mcp/commits/main) | Place search, reviews, nearby places, reverse geocoding, air quality, car, bike, walking and transit directions, traffic-zone checks |
- | [balad-mcp](https://github.com/sepehr071/balad-mcp) | [Balad](https://balad.ir) | 9 | [](https://pypi.org/project/balad-mcp/) | [](https://github.com/sepehr071/balad-mcp/commits/main) | Places and addresses, nearby and nearest by driving time, places along a route, hours, reviews, driving directions with live traffic |
- | [iran-roads-mcp](https://github.com/sepehr071/iran-roads-mcp) | [141.ir](https://141.ir) | 8 | [](https://pypi.org/project/iran-roads-mcp/) | [](https://github.com/sepehr071/iran-roads-mcp/commits/main) | Road bulletins, closures, traffic restrictions, road works, road weather, main routes |
- | [iran-weather-mcp](https://github.com/sepehr071/iran-weather-mcp) | [IRIMO](https://www.irimo.ir) | 9 | [](https://pypi.org/project/iran-weather-mcp/) | [](https://github.com/sepehr071/iran-weather-mcp/commits/main) | City forecasts, live observations, weather warnings, road and airport weather, bulletins |
- ### 🩺 Health
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [paziresh24-mcp](https://github.com/sepehr071/paziresh24-mcp) | [Paziresh24](https://www.paziresh24.com) | 12 | [](https://pypi.org/project/paziresh24-mcp/) | [](https://github.com/sepehr071/paziresh24-mcp/commits/main) | Doctors, visit prices, reviews, free appointment slots |
- | [doctoreto-mcp](https://github.com/sepehr071/doctoreto-mcp) | [Doctoreto](https://doctoreto.com) | 14 | [](https://pypi.org/project/doctoreto-mcp/) | [](https://github.com/sepehr071/doctoreto-mcp/commits/main) | Doctors, visit fees, free slots, reviews, clinics, labs, offers |
- | [exiryab-mcp](https://github.com/sshnevis/exiryab-mcp) | [ExirYab](https://exiryab.com) (official) | 3 | [](https://pypi.org/project/exiryab-mcp/) | [](https://github.com/sshnevis/exiryab-mcp/commits/main) | Find a doctor by name, city and specialty: profile, clinics, phones, hours, map location |
- | [darukade-mcp](https://github.com/sepehr071/darukade-mcp) | [Darukade](https://darukade.com) (online pharmacy) | 12 | [](https://pypi.org/project/darukade-mcp/) | [](https://github.com/sepehr071/darukade-mcp/commits/main) | Pharmacy and care products: prices, cheapest, ingredients, usage, reviews |
- ### 📚 Books
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [taaghche-mcp](https://github.com/sepehr071/taaghche-mcp) | [Taaghche](https://taaghche.com) | 12 | [](https://pypi.org/project/taaghche-mcp/) | [](https://github.com/sepehr071/taaghche-mcp/commits/main) | Ebooks and audiobooks: prices, discounts, reviews, bestsellers, free books |
- | [fidibo-mcp](https://github.com/sepehr071/fidibo-mcp) | [Fidibo](https://fidibo.com) | 11 | [](https://pypi.org/project/fidibo-mcp/) | [](https://github.com/sepehr071/fidibo-mcp/commits/main) | Ebooks and audiobooks: prices, Fidibo Plus, reviews, bestsellers, free books |
- | [30book-mcp](https://github.com/sepehr071/30book-mcp) | [30book](https://www.30book.com) | 14 | [](https://pypi.org/project/30book-mcp/) | [](https://github.com/sepehr071/30book-mcp/commits/main) | Printed books: list and discounted price, stock, editions, ISBN, deals |
- | [iranketab-mcp](https://github.com/sepehr071/iranketab-mcp) | [Iranketab](https://www.iranketab.ir) | 13 | [](https://pypi.org/project/iranketab-mcp/) | [](https://github.com/sepehr071/iranketab-mcp/commits/main) | Printed books: translations and editions compared, ratings, reviews, prices |
- ### 🎓 Learning, apps and downloads
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [maktabkhooneh-mcp](https://github.com/sepehr071/maktabkhooneh-mcp) | [Maktabkhooneh](https://maktabkhooneh.org) | 12 | [](https://pypi.org/project/maktabkhooneh-mcp/) | [](https://github.com/sepehr071/maktabkhooneh-mcp/commits/main) | Persian online courses: cheapest and free courses, deals, curriculum, teachers, reviews |
- | [iran-apps-mcp](https://github.com/sepehr071/iran-apps-mcp) | [Cafe Bazaar](https://cafebazaar.ir) and [Myket](https://myket.ir) | 6 | [](https://pypi.org/project/iran-apps-mcp/) | [](https://github.com/sepehr071/iran-apps-mcp/commits/main) | Android apps: search, compare across both stores, top lists, similar apps |
- | [iran-downloads-mcp](https://github.com/sepehr071/iran-downloads-mcp) | [Soft98](https://soft98.ir), [P30Download](https://p30download.ir), [Downloadly](https://downloadly.ir), [VGDL](https://vgdl.ir) | 4 | [](https://pypi.org/project/iran-downloads-mcp/) | [](https://github.com/sepehr071/iran-downloads-mcp/commits/main) | Metadata-only search of software and game download sites: returns the item page, never a download link |
- | [faradars-mcp](https://github.com/sepehr071/faradars-mcp) | [Faradars](https://faradars.org) | 16 | [](https://pypi.org/project/faradars-mcp/) | [](https://github.com/sepehr071/faradars-mcp/commits/main) | Persian online courses: prices, syllabus, instructors, learning paths, offers |
- ### 💼 Jobs and freelance
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [jobinja-mcp](https://github.com/sepehr071/jobinja-mcp) | [Jobinja](https://jobinja.ir) | 10 | [](https://pypi.org/project/jobinja-mcp/) | [](https://github.com/sepehr071/jobinja-mcp/commits/main) | Job search, ad details, companies, salary stats, skills in demand |
- | [jobvision-mcp](https://github.com/sepehr071/jobvision-mcp) | [Jobvision](https://jobvision.ir) | 14 | [](https://pypi.org/project/jobvision-mcp/) | [](https://github.com/sepehr071/jobvision-mcp/commits/main) | Job search, advertised pay, companies, interview reports, job market |
- | [irantalent-mcp](https://github.com/sepehr071/irantalent-mcp) | [IranTalent](https://www.irantalent.com) | 11 | [](https://pypi.org/project/irantalent-mcp/) | [](https://github.com/sepehr071/irantalent-mcp/commits/main) | Job search, companies, employee reviews, salary reports |
- | [quera-mcp](https://github.com/sepehr071/quera-mcp) | [Quera](https://quera.org) | 14 | [](https://pypi.org/project/quera-mcp/) | [](https://github.com/sepehr071/quera-mcp/commits/main) | Tech jobs, companies, salaries, contests, programming problems, courses and bootcamps |
- | [iran-jobs-mcp](https://github.com/sepehr071/iran-jobs-mcp) | [IranTalent](https://www.irantalent.com), [Jobinja](https://jobinja.ir), [Jobvision](https://jobvision.ir) | 37 | [](https://pypi.org/project/iran-jobs-mcp/) | [](https://github.com/sepehr071/iran-jobs-mcp/commits/main) | Job ads, companies, reviews, interview reports and pay on three job sites side by side |
- | [ponisha-mcp](https://github.com/sepehr071/ponisha-mcp) | [Ponisha](https://ponisha.ir) | 14 | [](https://pypi.org/project/ponisha-mcp/) | [](https://github.com/sepehr071/ponisha-mcp/commits/main) | Freelance projects and bids, freelancers, services, skill demand |
- | [karlancer-mcp](https://github.com/sepehr071/karlancer-mcp) | [Karlancer](https://www.karlancer.com) | 14 | [](https://pypi.org/project/karlancer-mcp/) | [](https://github.com/sepehr071/karlancer-mcp/commits/main) | Freelance projects, freelancers, services, market rates, trending skills |
- ### 📈 Markets and economy
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [tsetmc-mcp](https://github.com/sepehr071/tsetmc-mcp) | [TSETMC](https://tsetmc.com) | 8 | [](https://pypi.org/project/tsetmc-mcp/) | [](https://github.com/sepehr071/tsetmc-mcp/commits/main) | Tehran Stock Exchange quotes, movers, order book, history, indices, real versus legal trading (Rial) |
- | [codal-mcp](https://github.com/sepehr071/codal-mcp) | [Codal](https://codal.ir) | 5 | [](https://pypi.org/project/codal-mcp/) | [](https://github.com/sepehr071/codal-mcp/commits/main) | Listed companies' filings: financial statements, EPS, monthly activity reports as tables, meeting decisions (million Rial) |
- | [ifb-mcp](https://github.com/sepehr071/ifb-mcp) | [Iran Fara Bourse](https://www.ifb.ir) | 16 | [](https://pypi.org/project/ifb-mcp/) | [](https://github.com/sepehr071/ifb-mcp/commits/main) | Bond and sukuk yields, treasury bills, yield curve, IPOs, announcements, market stats (Rial) |
- | [fipiran-mcp](https://github.com/sepehr071/fipiran-mcp) | [Fipiran](https://fipiran.ir) | 11 | [](https://pypi.org/project/fipiran-mcp/) | [](https://github.com/sepehr071/fipiran-mcp/commits/main) | Mutual funds and ETFs: NAV, returns, size, managers, fund comparison |
- | [ime-mcp](https://github.com/sepehr071/ime-mcp) | [Iran Mercantile Exchange](https://www.ime.co.ir) | 14 | [](https://pypi.org/project/ime-mcp/) | [](https://github.com/sepehr071/ime-mcp/commits/main) | Commodity trades, supply offers, price history, market totals, options, deposit certificates (Rial) |
- | [iran-brokers-mcp](https://github.com/sepehr071/iran-brokers-mcp) | [Mofid](https://www.emofid.com), [Agah](https://agah.com) | 22 | [](https://pypi.org/project/iran-brokers-mcp/) | [](https://github.com/sepehr071/iran-brokers-mcp/commits/main) | Stocks, ETFs and funds, options, bonds and sukuk, gold and coin, screeners, Codal news, through two brokers (Rial) |
- | [cbi-mcp](https://github.com/sepehr071/cbi-mcp) | [Central Bank of Iran](https://www.cbi.ir) | 11 | [](https://pypi.org/project/cbi-mcp/) | [](https://github.com/sepehr071/cbi-mcp/commits/main) | Official exchange rates and their history, inflation, policy rates, liquidity, bond auctions, news (Rial) |
- | [amar-mcp](https://github.com/sepehr071/amar-mcp) | [Statistical Centre of Iran](https://amar.org.ir) | 12 | [](https://pypi.org/project/amar-mcp/) | [](https://github.com/sepehr071/amar-mcp/commits/main) | CPI inflation, unemployment, population, GDP, producer prices, release tables and calendar |
- ### 📊 Prices, news and public records
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [tgju-mcp](https://github.com/sepehr071/tgju-mcp) | [TGJU](https://www.tgju.org) | 6 | [](https://pypi.org/project/tgju-mcp/) | [](https://github.com/sepehr071/tgju-mcp/commits/main) | Live gold, coin, dollar, euro and crypto prices, market tables, daily history |
- | [iran-crypto-mcp](https://github.com/sepehr071/iran-crypto-mcp) | [Nobitex](https://nobitex.ir), [Wallex](https://wallex.ir), [Bitpin](https://bitpin.ir), [Ramzinex](https://ramzinex.com), [Tabdeal](https://tabdeal.org), [OMPFinex](https://ompfinex.com), [Exir](https://exir.io) | 12 | [](https://pypi.org/project/iran-crypto-mcp/) | [](https://github.com/sepehr071/iran-crypto-mcp/commits/main) | Compare a coin's price across 7 exchanges in Toman, order books, trades, candles, top movers |
- | [milligold-mcp](https://github.com/sepehr071/milligold-mcp) | [Milli.gold](https://milli.gold) | 8 | [](https://pypi.org/project/milligold-mcp/) | [](https://github.com/sepehr071/milligold-mcp/commits/main) | Live 18k gold price per gram, history, fees and trade cost quotes, latest news and help articles, platform statistics |
- | [iran-gold-mcp](https://github.com/sepehr071/iran-gold-mcp) | [Milli.gold](https://milli.gold), [Wallgold](https://wallgold.ir), [Melligold](https://melligold.com), [Daric](https://daric.gold), [Taline](https://taline.ir) | 3 | [](https://pypi.org/project/iran-gold-mcp/) | [](https://github.com/sepehr071/iran-gold-mcp/commits/main) | 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](https://github.com/sepehr071/iran-news-mcp) | [Mehr](https://www.mehrnews.com), [Khabaronline](https://www.khabaronline.ir), [Hamshahri](https://www.hamshahrionline.ir), [Tabnak](https://www.tabnak.ir), [Entekhab](https://www.entekhab.ir), [Asriran](https://www.asriran.com), [Zoomit](https://www.zoomit.ir), [Digiato](https://digiato.com), [Varzesh3](https://www.varzesh3.com), [Khabarvarzeshi](https://www.khabarvarzeshi.com) | 6 | [](https://pypi.org/project/iran-news-mcp/) | [](https://github.com/sepehr071/iran-news-mcp/commits/main) | Latest headlines by source and category, keyword search, full article text |
- | [digiato-mcp](https://github.com/sepehr071/digiato-mcp) | [Digiato](https://digiato.com) | 8 | [](https://pypi.org/project/digiato-mcp/) | [](https://github.com/sepehr071/digiato-mcp/commits/main) | Tech news: latest, by category or tag, search, reviews, full articles |
- | [iran-quake-mcp](https://github.com/sepehr071/iran-quake-mcp) | [IRSC](https://irsc.ut.ac.ir), [USGS](https://earthquake.usgs.gov), [EMSC](https://www.emsc-csem.org) | 5 | [](https://pypi.org/project/iran-quake-mcp/) | [](https://github.com/sepehr071/iran-quake-mcp/commits/main) | Latest and strongest earthquakes in Iran, history search, event detail, activity stats |
- | [qavanin-mcp](https://github.com/sepehr071/qavanin-mcp) | [qavanin.ir](https://qavanin.ir) | 7 | [](https://pypi.org/project/qavanin-mcp/) | [](https://github.com/sepehr071/qavanin-mcp/commits/main) | 168,000 laws, regulations and court votes: search, full text, one article, amendments, related documents |
- | [iran-tax-mcp](https://github.com/sepehr071/iran-tax-mcp) | [tax.gov.ir](https://tax.gov.ir), [stuffid.tax.gov.ir](https://stuffid.tax.gov.ir), [regulation.tax.gov.ir](https://regulation.tax.gov.ir) | 6 | [](https://pypi.org/project/iran-tax-mcp/) | [](https://github.com/sepehr071/iran-tax-mcp/commits/main) | E-invoice goods/service IDs with VAT rate, activity codes, property transaction values, tax laws and circulars, official FAQ |
- | [iran-insurance-mcp](https://github.com/sepehr071/iran-insurance-mcp) | [BimeBazar](https://bimebazar.com), [Azki](https://www.azki.com) | 18 | [](https://pypi.org/project/iran-insurance-mcp/) | [](https://github.com/sepehr071/iran-insurance-mcp/commits/main) | Insurers and ratings, travel, third-party, car body, motorcycle, fire and health quotes side by side |
- | [rasmio-mcp](https://github.com/sepehr071/rasmio-mcp) | [Rasmio](https://rasmio.com) | 8 | [](https://pypi.org/project/rasmio-mcp/) | [](https://github.com/sepehr071/rasmio-mcp/commits/main) | Iranian companies, board members, Official Gazette ads, products, brands, trademarks and patents (Rial) |
- | [varzesh3-mcp](https://github.com/sepehr071/varzesh3-mcp) | [Varzesh3](https://www.varzesh3.com) | 18 | [](https://pypi.org/project/varzesh3-mcp/) | [](https://github.com/sepehr071/varzesh3-mcp/commits/main) | Live scores, league tables, fixtures, teams, players, top scorers, transfers, TV schedule, news |
- | [gamefa-mcp](https://github.com/sepehr071/gamefa-mcp) | [Gamefa](https://gamefa.com) | 13 | [](https://pypi.org/project/gamefa-mcp/) | [](https://github.com/sepehr071/gamefa-mcp/commits/main) | Game and film news, reviews with scores, game and film profiles, upcoming releases |
- | [iran-vod-mcp](https://github.com/sepehr071/iran-vod-mcp) | [Filimo](https://www.filimo.com), [Namava](https://www.namava.ir) | 13 | [](https://pypi.org/project/iran-vod-mcp/) | [](https://github.com/sepehr071/iran-vod-mcp/commits/main) | Films and series on Filimo and Namava: search, where to watch, title details, episodes, new releases, collections, plans |
- | [time-ir-mcp](https://github.com/sepehr071/time-ir-mcp) | [Time.ir](https://www.time.ir) | 13 | [](https://pypi.org/project/time-ir-mcp/) | [](https://github.com/sepehr071/time-ir-mcp/commits/main) | Jalali, Gregorian and Hijri dates, holidays and long weekends, events, prayer times, qibla |
- | [rrk-mcp](https://github.com/sepehr071/rrk-mcp) | [Official Gazette](https://rrk.ir) (rrk.ir) | 5 | [](https://pypi.org/project/rrk-mcp/) | [](https://github.com/sepehr071/rrk-mcp/commits/main) | Laws, regulations and rulings published in the Official Gazette: search, latest, full text |
- | [iran-cloud-status-mcp](https://github.com/sepehr071/iran-cloud-status-mcp) | [ArvanCloud](https://www.arvancloud.ir), [Hamravesh](https://hamravesh.com), [Chabokan](https://chabokan.net), [Liara](https://liara.ir) | 10 | [](https://pypi.org/project/iran-cloud-status-mcp/) | [](https://github.com/sepehr071/iran-cloud-status-mcp/commits/main) | Live status, incidents, planned maintenance, reliability, public prices compared |
- ### 🎬 Video, radio and events
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [aparat-mcp](https://github.com/sepehr071/aparat-mcp) | [Aparat](https://www.aparat.com) | 8 | [](https://pypi.org/project/aparat-mcp/) | [](https://github.com/sepehr071/aparat-mcp/commits/main) | Video search, video details and comments, related videos, channels, categories, trending |
- | [namasha-mcp](https://github.com/sepehr071/namasha-mcp) | [Namasha](https://www.namasha.com) | 9 | [](https://pypi.org/project/namasha-mcp/) | [](https://github.com/sepehr071/namasha-mcp/commits/main) | Video search, video details and comments, channels, featured videos, categories |
- | [telewebion-mcp](https://github.com/sepehr071/telewebion-mcp) | [Telewebion](https://telewebion.ir) | 7 | [](https://pypi.org/project/telewebion-mcp/) | [](https://github.com/sepehr071/telewebion-mcp/commits/main) | IRIB TV channels, schedules, what's on now, programs, episodes, live sports |
- | [iranseda-mcp](https://github.com/sepehr071/iranseda-mcp) | [Iranseda](https://www.iranseda.ir) | 9 | [](https://pypi.org/project/iranseda-mcp/) | [](https://github.com/sepehr071/iranseda-mcp/commits/main) | IRIB radio channels, live streams and schedules, programs, audiobooks, music, Quran |
- | [cinematicket-mcp](https://github.com/sepehr071/cinematicket-mcp) | [Cinematicket](https://cinematicket.org) | 10 | [](https://pypi.org/project/cinematicket-mcp/) | [](https://github.com/sepehr071/cinematicket-mcp/commits/main) | Films now showing, cinemas, showtimes and ticket prices, upcoming films, theatre, box office |
- | [tiwall-mcp](https://github.com/sepehr071/tiwall-mcp) | [Tiwall](https://www.tiwall.com) | 9 | [](https://pypi.org/project/tiwall-mcp/) | [](https://github.com/sepehr071/tiwall-mcp/commits/main) | Theatre, concerts and events: search, sessions and prices, venues, reviews |
- ### 📖 Dictionary, encyclopedia and community
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [iran-dictionary-mcp](https://github.com/sepehr071/iran-dictionary-mcp) | [Abadis](https://abadis.ir), [Vajehyab](https://vajehyab.com) | 7 | [](https://pypi.org/project/iran-dictionary-mcp/) | [](https://github.com/sepehr071/iran-dictionary-mcp/commits/main) | Word meanings, synonyms, English and Persian translation, Persian names |
- | [persian-wikipedia-mcp](https://github.com/sepehr071/persian-wikipedia-mcp) | [Persian Wikipedia](https://fa.wikipedia.org) | 9 | [](https://pypi.org/project/persian-wikipedia-mcp/) | [](https://github.com/sepehr071/persian-wikipedia-mcp/commits/main) | Article search, summaries, full text and sections, infoboxes, trending, nearby places |
- | [virgool-mcp](https://github.com/sepehr071/virgool-mcp) | [Virgool](https://virgool.io) | 11 | [](https://pypi.org/project/virgool-mcp/) | [](https://github.com/sepehr071/virgool-mcp/commits/main) | Persian blog posts, comments, authors, topics, tags, publications |
- | [ninisite-mcp](https://github.com/sepehr071/ninisite-mcp) | [Ninisite](https://www.ninisite.com) | 8 | [](https://pypi.org/project/ninisite-mcp/) | [](https://github.com/sepehr071/ninisite-mcp/commits/main) | Parenting forum topics, hot threads, articles, pregnancy week by week |
- ### 💳 Your own accounts (need a token or sign-in)
- | Server | Site | Tools | Version | Updated | What your agent can do |
- |---|---|---:|:---:|:---:|---|
- | [payping-mcp](https://github.com/sepehr071/payping-mcp) | [PayPing](https://www.payping.ir) | 21 | [](https://pypi.org/project/payping-mcp/) | [](https://github.com/sepehr071/payping-mcp/commits/main) | Read balance, sales, customers; create products, payment links, coupons, invoices |
- | [bale-mcp](https://github.com/sepehr071/bale-mcp) | [Bale](https://bale.ai) messenger | 13 | [](https://pypi.org/project/bale-mcp/) | [](https://github.com/sepehr071/bale-mcp/commits/main) | Read and answer your bot's messages, ask and wait for replies, send files |
- | [swapwallet-mcp](https://github.com/SwapWallet/swapwallet-mcp) | [SwapWallet](https://swapwallet.app) (official, hosted) | 13 | [](https://registry.modelcontextprotocol.io/v0.1/servers/app.swapwallet%2Fmcp/versions/latest) | [](https://github.com/SwapWallet/swapwallet-mcp/commits/main) | 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](TOOLS.md).
- ## For AI agents
- This repo is built to be read by agents as much as by people:
- | File | What it is |
- |---|---|
- | [`AGENTS.md`](AGENTS.md) | Which server to pick for which task, conventions, safety rules, how to work in this repo |
- | [`servers.json`](servers.json) | Machine-readable catalog: package or URL, version, category, env vars and every tool of each server |
- | [`TOOLS.md`](TOOLS.md) | All 1150 tools grouped by server, one line each |
- | [`llms.txt`](llms.txt) | Short index for LLMs ([llmstxt.org](https://llmstxt.org)) |
- | [`.mcp.json`](.mcp.json) | Ready-to-use config for every server |
- | [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) | The `iran-mcp` plugin marketplace: one plugin per server plus bundles |
- | [`plugins/`](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`](PLUGINS.md) | Agent compatibility, and how a server release reaches plugin users |
- Paste this into your agent to set it up:
- ```text
- Read https://raw.githubusercontent.com/sepehr071/iran-mcp/main/AGENTS.md, then add the MCP servers I need for <task> to my MCP config.
- ```
- ## Shared conventions
- - **Prices are Toman**, even where the site's API returns Rial. The exceptions are market data that is quoted in Rial:
- `tsetmc-mcp`, `codal-mcp`, `ifb-mcp`, `ime-mcp`, `cbi-mcp` and the NAV in `fipiran-mcp`. Their skills name the unit.
- - **Site servers are read-only.** Shop, travel, health and book servers never log in, fill a basket, book or pay.
- `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.
- - **Images:** product, stay, hotel and doctor results carry an `image` URL where the site has one.
- - **Proxy:** every package server reads an optional `<NAME>_MCP_PROXY` env var (e.g. `DIGIKALA_MCP_PROXY`) for sites
- that block your IP. System proxy settings are ignored. See [`servers.json`](servers.json) for exact names.
- - Same layout for every package server: `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](https://registry.modelcontextprotocol.io).
- ## Working from source
- 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.
- ```bash
- 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 site
- ```
- Pull every server to its latest `main` and rebuild the catalog:
- ```bash
- 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 plugin
- ```
- A nightly GitHub Action does all of this and commits the result. The full release flow is in [PLUGINS.md](PLUGINS.md).
- Bugs and feature requests for a server go to that server's own repo.
- ## FAQ
- <details>
- <summary><b>Are these official?</b></summary>
- 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](https://swapwallet.app/docs/mcp).
- `exiryab-mcp` is ExirYab's own server, on the public API listed in [exiryab.com/llms.txt](https://exiryab.com/llms.txt).
- `pasavard-mcp` is Pasavard's own hosted server; its store links are affiliate links, and every result says so.
- </details>
- <details>
- <summary><b>A site times out or returns 403 from outside Iran.</b></summary>
- 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.
- </details>
- <details>
- <summary><b>Can my agent order or pay for me?</b></summary>
- 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.
- </details>
- <details>
- <summary><b>Do I need Python?</b></summary>
- You need [uv](https://docs.astral.sh/uv/getting-started/installation/). `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.
- </details>
- <details>
- <summary><b>How do I get updates?</b></summary>
- 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.
- </details>
- If this saves you some tab-hopping, a star on the repo helps other people find it.
- ## Author
- <a href="https://www.linkedin.com/in/sepehr-radmard"><img src="assets/author-banner.png" alt="Sepehr Radmard: open-source MCP servers for the Iranian web. LinkedIn: linkedin.com/in/sepehr-radmard" width="100%"></a>
- Built and maintained by **Sepehr Radmard** (سپهر رادمرد). Connect on [LinkedIn](https://www.linkedin.com/in/sepehr-radmard) or follow [@sepehr071 on GitHub](https://github.com/sepehr071) for more MCP servers for Iranian websites. If this repo saves you some tab-hopping, a star helps other people find it.
- ## Support
- <a href="https://ppng.ir/mcpfarsi"><img src="assets/donate.svg" alt="Support iran-mcp: donate on PayPing" width="100%"></a>
- These servers are free and maintained in spare time. If they help you, you can support the work with a donation on [PayPing](https://ppng.ir/mcpfarsi). Starring the repo, reporting broken servers and sharing it also help.
- ## License
- <a href="https://www.linkedin.com/in/sepehr-radmard"><img src="https://raw.githubusercontent.com/sepehr071/iran-mcp/main/assets/license-banner.png" alt="استفادهٔ شخصی و غیرتجاری رایگان است؛ برای استفادهٔ تجاری با سپهر رادمرد تماس بگیرید. Free for personal and non-commercial use; commercial use needs a license." width="100%"></a>
- **استفادهٔ شخصی و غیرتجاری رایگان است.** این فهرست و همهٔ سرورهایش مجوز [PolyForm Noncommercial 1.0.0](LICENSE) دارند. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه [لینکدین](https://www.linkedin.com/in/sepehr-radmard) یا [گیت‌هاب](https://github.com/sepehr071) با سپهر رادمرد تماس بگیرید. نسخه‌هایی که پیش از ۲۶ آبان ۱۴۰۵ منتشر شده‌اند با مجوز MIT می‌مانند.
- Free for personal and non-commercial use: this catalog and every server in it are under the [PolyForm Noncommercial License 1.0.0](LICENSE). Using them in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on [LinkedIn](https://www.linkedin.com/in/sepehr-radmard) or [GitHub](https://github.com/sepehr071). Versions released before 2026-11-17 stay MIT.
- Site names, logos and trademarks belong to their owners and are shown only to identify each site.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.