New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Read-only Aparat (aparat.com) Iranian video platform: search, videos, channels, trending, comments.

GitHub stars
281
View on GitHub

Add marketplace

/plugin marketplace add sepehr071/iran-mcp

Run it inside Claude Code once, then install the plugin below.

Install

/plugin install aparat@iran-mcp

Run it inside Claude Code after adding the marketplace.

Files

Discovered from source

Aparat Videos

Read-only Aparat (aparat.com) Iranian video platform: search, videos, channels, trending, comments.

The tools below come from the aparat-mcp MCP server. If they are not available, install it with claude mcp add aparat -- uvx aparat-mcp, or add "aparat": {"command": "uvx", "args": ["aparat-mcp"]} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

  • apr_search: Search Aparat videos and channels by text.
  • apr_video: Get one Aparat video: title, description, views, likes, duration, tags, category, channel, publish date.
  • apr_comments: Read the top comments under an Aparat video (10 per page, most liked first as the site orders them).
  • apr_related: List videos Aparat recommends next to a video (about 10).
  • apr_channel: Get an Aparat channel: name, followers, video count, total views, description, start date.
  • apr_channel_videos: List a channel's videos, newest first or most viewed (10 per page).
  • apr_categories: List the category names Aparat's trending tabs use.
  • apr_trending: List trending Aparat videos, overall or in one category (up to 40).

Rules

  • Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
  • Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
  • Keep request rates low. These are undocumented site APIs that can change or rate-limit.
  • On timeouts or HTTP 403 outside Iran, set APARAT_MCP_PROXY to an HTTP proxy with an Iranian IP.

Maintainer

Sepehr Radmard: open-source MCP servers for the Iranian web

Built and maintained by Sepehr Radmard (سپهر رادمرد): LinkedIn · GitHub. More servers for Iranian websites: iran-mcp.

From the sepehr071/iran-mcp README

iran-mcp: 97 MCP servers and 1168 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

English · فارسی

Iran MCP servers: iran-mcp

Give your AI agent the Iranian web.
94 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.
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.

Servers Tools Claude Code plugins MCP Registry License: PolyForm Noncommercial Stars

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

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


What's new in v2.5

iran-mcp v2.5: 19 new servers, 5 new categories, 156 new tools, same tool names

Full list: CHANGELOG.md.

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

Full list: CHANGELOG.md.

What's new in v2.3 iran-mcp v2.3: 31 new servers, 9 new categories, 383 new tools, same tools and parameters

Full list: CHANGELOG.md.

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

Full list: CHANGELOG.md.

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

Full list: CHANGELOG.md.

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

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

Why

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

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

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

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

PickPrice (Toman)
FlightThursday 07:40, economy, 2 seats left2,180,000
Stay2-bedroom villa near the beach, 4.8 stars3,650,000 / night
DoctorDermatologist, Saturday 10:30, in-person450,000

Quick start

Every server is a small Python package on PyPI, run with uvx, except pasavard-mcp and swapwallet-mcp, which their sites host: you add them by URL, and sign in to SwapWallet once with OAuth. The site servers need no account and no API key. payping-mcp and bale-mcp work on your own account with your token, and swapwallet-mcp with your SwapWallet sign-in.

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

claude plugin marketplace add sepehr071/iran-mcp
claude plugin install digikala@iran-mcp            # one server
claude plugin install iran-travel@iran-mcp         # a bundle: food, shopping, cars, travel, maps, jobs, ...
claude plugin install iran-all@iran-mcp            # every read-only site server

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

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

npx skills add sepehr071/iran-mcp

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

One server (Claude Code, without the plugin):

claude mcp add digikala -- uvx digikala-mcp
claude mcp add --transport http swapwallet https://swapwallet.app/mcp   # hosted; then sign in from /mcp
claude mcp add --transport http pasavard https://pasavard.ir/api/mcp      # hosted, no sign-in

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

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

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

All 97 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] 1168 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

mcpfarsi.ir: the Persian marketplace of MCP servers and Agent Skills for Iranian services

Don't want to install anything? 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

ServerSiteToolsVersionUpdatedWhat your agent can do
digikala-mcpDigikala (incl. Fresh)23PyPILast commitSearch with feature filters, best picks for a budget, every seller, price history, reviews, deals
technolife-mcpTechnolife19PyPILast commitElectronics: each seller's cash and installment price, specs, reviews, deals
masterkala-mcpMasterKala14PyPILast commitGadgets and accessories: prices, specs, deals
baneh-mcpBaneh7PyPILast commitAppliances, TVs and electronics: cheapest in-stock price, brands, reviews
torob-mcpTorob (price comparison)26PyPILast commitEvery shop's price for a product, price history, deal checks, installments, cheapest shop for a basket
basalam-mcpBasalam (marketplace)7PyPILast commitGoods from thousands of small shops: price, shipping and discount filters, cheapest offers, shop ratings, reviews
shopino-mcpShopino14PyPILast commitFashion from thousands of shops: prices, sizes, stock, shop ratings
banimode-mcpBanimode7PyPILast commitFashion: prices, sizes, stock, brands, deals, reviews
digistyle-mcpDigistyle6PyPILast commitFashion: search with filters, product details, brands, deals
pasavard-mcpPasavard (official, hosted)4VersionLast commitDigikala and Snappshop prices tracked hourly: best picks per budget against each product's 30-day low, with affiliate and cashback links
emalls-ir-mcpEmalls (price comparison)10PyPILast commitProducts across Iranian shops, every shop's offer, price history, shops
mobile-ir-mcpMobile.ir17PyPILast commitPhone specs, shop prices, price history, used phones, SIM numbers
zoomit-mcpZoomit (Zoobin)12PyPILast commitPhone, laptop and GPU specs, shop prices, price history, comparisons, reviews
snappshop-mcpSnapp! Shop13PyPILast commitMarketplace search, categories, every seller's offer in Toman, reviews, flash sales

🏠 Classifieds

ServerSiteToolsVersionUpdatedWhat your agent can do
divar-mcpDivar31PyPILast commitHomes, cars, phones and more in any city: cheapest and best-value ads, fair-price check, market stats, new-ad alerts
sheypoor-mcpSheypoor11PyPILast commitAds in any city, ad details, price summaries for cars and homes, shops
kilid-mcpKilid8PyPILast commitHomes for sale and rent, districts, price per square metre, agencies

🚗 Cars

ServerSiteToolsVersionUpdatedWhat your agent can do
bama-ir-mcpBama12PyPILast commitCar ads, market prices, new-car price lists, dealers, specs
karnameh-mcpKarnameh15PyPILast commitUsed-car ads, specs and comparisons, new-car market prices and price history
hamrah-mechanic-mcpHamrah Mechanic12PyPILast commitDaily car prices, price estimates, used cars for sale, inspection fees
khodro45-mcpKhodro4510PyPILast commitUsed cars with inspection reports, price estimate, deals, new-car prices

💄 Beauty

ServerSiteToolsVersionUpdatedWhat your agent can do
khanoumi-mcpKhanoumi12PyPILast commitCosmetics, skin and hair care, perfume: prices, shades, reviews, deals
asalbanoo-mcpAsal Banoo12PyPILast commitCosmetics and hair care: prices, variants, deals

🍕 Food and groceries

ServerSiteToolsVersionUpdatedWhat your agent can do
snapp-mcpSnappfood + SnappMarket21PyPILast commitCheapest dish near you, menus, FoodParty flash deals, groceries
okala-mcpOkala16PyPILast commitGrocery stores that deliver to you, prices across stores, deals
tapsifood-mcpTapsi Food11PyPILast commitDishes and restaurants near you, menus, flash deals, discounted restaurants, reviews

✈️ Travel and stays

ServerSiteToolsVersionUpdatedWhat your agent can do
mrbilit-mcpMrBilit22PyPILast commitCheapest flights, trains, buses, taxis and hotels; seats and refund rules
flytoday-mcpFlytoday22PyPILast commitFlights, trains, buses, hotels, villas; CIP, eSIM, visas, activities
jabama-mcpJabama, Jabama Tours, Jabama Events21PyPILast commitStays with exact prices, group tours, events and theater tickets
otaghak-mcpOtaghak15PyPILast commitVillas and cottages: availability, exact stay price, reviews, hosts
alibaba-ir-mcpAlibaba14PyPILast commitCheapest domestic and international flights, trains, buses, hotels, villas and tours
eghamat24-mcpEghamat2414PyPILast commitHotels: room prices for your dates, price calendar, deals, reviews, tours
snapptrip-mcpSnappTrip10PyPILast commitHotels: search, rooms, price calendar, reviews; domestic flights and fares
raja-mcpRaja5PyPILast commitTrains: stations, search with prices and free seats, stops and timetables, announcements
iran-bus-mcpSafar7245PyPILast commitBus trips with Toman prices and free seats, the cheapest ticket, terminals

🗺️ Maps, roads and weather

ServerSiteToolsVersionUpdatedWhat your agent can do
neshan-mcpNeshan11PyPILast commitPlace search, reviews, nearby places, reverse geocoding, air quality, car, bike, walking and transit directions, traffic-zone checks
balad-mcpBalad9PyPILast commitPlaces and addresses, nearby and nearest by driving time, places along a route, hours, reviews, driving directions with live traffic
iran-roads-mcp141.ir8PyPILast commitRoad bulletins, closures, traffic restrictions, road works, road weather, main routes
iran-weather-mcpIRIMO9PyPILast commitCity forecasts, live observations, weather warnings, road and airport weather, bulletins

🩺 Health

ServerSiteToolsVersionUpdatedWhat your agent can do
paziresh24-mcpPaziresh2412PyPILast commitDoctors, visit prices, reviews, free appointment slots
doctoreto-mcpDoctoreto14PyPILast commitDoctors, visit fees, free slots, reviews, clinics, labs, offers
exiryab-mcpExirYab (official)3PyPILast commitFind a doctor by name, city and specialty: profile, clinics, phones, hours, map location
darukade-mcpDarukade (online pharmacy)12PyPILast commitPharmacy and care products: prices, cheapest, ingredients, usage, reviews

📚 Books

ServerSiteToolsVersionUpdatedWhat your agent can do
taaghche-mcpTaaghche12PyPILast commitEbooks and audiobooks: prices, discounts, reviews, bestsellers, free books
fidibo-mcpFidibo11PyPILast commitEbooks and audiobooks: prices, Fidibo Plus, reviews, bestsellers, free books
30book-mcp30book14PyPILast commitPrinted books: list and discounted price, stock, editions, ISBN, deals
iranketab-mcpIranketab13PyPILast commitPrinted books: translations and editions compared, ratings, reviews, prices

🎓 Learning, apps and downloads

ServerSiteToolsVersionUpdatedWhat your agent can do
maktabkhooneh-mcpMaktabkhooneh12PyPILast commitPersian online courses: cheapest and free courses, deals, curriculum, teachers, reviews
iran-apps-mcpCafe Bazaar and Myket6PyPILast commitAndroid apps: search, compare across both stores, top lists, similar apps
iran-downloads-mcpSoft98, P30Download, Downloadly, VGDL4PyPILast commitMetadata-only search of software and game download sites: returns the item page, never a download link
faradars-mcpFaradars16PyPILast commitPersian online courses: prices, syllabus, instructors, learning paths, offers

💼 Jobs and freelance

ServerSiteToolsVersionUpdatedWhat your agent can do
jobinja-mcpJobinja10PyPILast commitJob search, ad details, companies, salary stats, skills in demand
jobvision-mcpJobvision14PyPILast commitJob search, advertised pay, companies, interview reports, job market
irantalent-mcpIranTalent11PyPILast commitJob search, companies, employee reviews, salary reports
quera-mcpQuera14PyPILast commitTech jobs, companies, salaries, contests, programming problems, courses and bootcamps
iran-jobs-mcpIranTalent, Jobinja, Jobvision37PyPILast commitJob ads, companies, reviews, interview reports and pay on three job sites side by side
ponisha-mcpPonisha14PyPILast commitFreelance projects and bids, freelancers, services, skill demand
karlancer-mcpKarlancer14PyPILast commitFreelance projects, freelancers, services, market rates, trending skills

📈 Markets and economy

ServerSiteToolsVersionUpdatedWhat your agent can do
tsetmc-mcpTSETMC8PyPILast commitTehran Stock Exchange quotes, movers, order book, history, indices, real versus legal trading (Rial)
codal-mcpCodal5PyPILast commitListed companies' filings: financial statements, EPS, monthly activity reports as tables, meeting decisions (million Rial)
ifb-mcpIran Fara Bourse16PyPILast commitBond and sukuk yields, treasury bills, yield curve, IPOs, announcements, market stats (Rial)
fipiran-mcpFipiran11PyPILast commitMutual funds and ETFs: NAV, returns, size, managers, fund comparison
ime-mcpIran Mercantile Exchange14PyPILast commitCommodity trades, supply offers, price history, market totals, options, deposit certificates (Rial)
iran-brokers-mcpMofid, Agah22PyPILast commitStocks, ETFs and funds, options, bonds and sukuk, gold and coin, screeners, Codal news, through two brokers (Rial)
cbi-mcpCentral Bank of Iran11PyPILast commitOfficial exchange rates and their history, inflation, policy rates, liquidity, bond auctions, news (Rial)
amar-mcpStatistical Centre of Iran12PyPILast commitCPI inflation, unemployment, population, GDP, producer prices, release tables and calendar

📊 Prices, news and public records

ServerSiteToolsVersionUpdatedWhat your agent can do
tgju-mcpTGJU6PyPILast commitLive gold, coin, dollar, euro and crypto prices, market tables, daily history
iran-crypto-mcpNobitex, Wallex, Bitpin, Ramzinex, Tabdeal, OMPFinex, Exir12PyPILast commitCompare a coin's price across 7 exchanges in Toman, order books, trades, candles, top movers
milligold-mcpMilli.gold8PyPILast commitLive 18k gold price per gram, history, fees and trade cost quotes, latest news and help articles, platform statistics
iran-gold-mcpMilli.gold, Wallgold, Melligold, Daric, Taline3PyPILast commitCompare 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-mcpMehr, Khabaronline, Hamshahri, Tabnak, Entekhab, Asriran, Zoomit, Digiato, Varzesh3, Khabarvarzeshi6PyPILast commitLatest headlines by source and category, keyword search, full article text
digiato-mcpDigiato8PyPILast commitTech news: latest, by category or tag, search, reviews, full articles
iran-quake-mcpIRSC, USGS, EMSC5PyPILast commitLatest and strongest earthquakes in Iran, history search, event detail, activity stats
qavanin-mcpqavanin.ir7PyPILast commit168,000 laws, regulations and court votes: search, full text, one article, amendments, related documents
iran-tax-mcptax.gov.ir, stuffid.tax.gov.ir, regulation.tax.gov.ir6PyPILast commitE-invoice goods/service IDs with VAT rate, activity codes, property transaction values, tax laws and circulars, official FAQ
iran-insurance-mcpBimeBazar, Azki18PyPILast commitInsurers and ratings, travel, third-party, car body, motorcycle, fire and health quotes side by side
rasmio-mcpRasmio8PyPILast commitIranian companies, board members, Official Gazette ads, products, brands, trademarks and patents (Rial)
varzesh3-mcpVarzesh318PyPILast commitLive scores, league tables, fixtures, teams, players, top scorers, transfers, TV schedule, news
gamefa-mcpGamefa13PyPILast commitGame and film news, reviews with scores, game and film profiles, upcoming releases
iran-vod-mcpFilimo, Namava13PyPILast commitFilms and series on Filimo and Namava: search, where to watch, title details, episodes, new releases, collections, plans
time-ir-mcpTime.ir13PyPILast commitJalali, Gregorian and Hijri dates, holidays and long weekends, events, prayer times, qibla
rrk-mcpOfficial Gazette (rrk.ir)5PyPILast commitLaws, regulations and rulings published in the Official Gazette: search, latest, full text
iran-cloud-status-mcpArvanCloud, Hamravesh, Chabokan, Liara10PyPILast commitLive status, incidents, planned maintenance, reliability, public prices compared

🎬 Video, radio and events


View the full README.md on GitHub

Details

Marketplace
sepehr071/iran-mcp
Source
plugins/aparat
Category
Media

More from sepehr071/iran-mcp

All 121

Similar to aparat

More Media & Audio/Video