Iran Apps

For AI agents

• What: unofficial MCP server (model context protocol) for the two big Iranian Android app stores, Cafe Bazaar (cafebazaar.ir) and Myket (myket.ir). Queries work in Persian and English.
• Install: uvx iran-apps-mcp or claude mcp add iran-apps -- uvx iran-apps-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional IRAN_APPS_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
• Access: read-only, metadata only. It cannot log in, post reviews or download anything, so no confirmation is needed before calling any tool. Every result carries the store page URL.
• Tools: 6, all prefixed ap_. Typical sequence: ap_search (get the package name) -> ap_compare or ap_app -> ap_similar. For lists, call ap_categories first and pass a slug to ap_top.
• Use when: the user asks about an Android app's version, rating, installs, size or update date on the Iranian stores; whether Myket lags Bazaar; top or new apps in a category; alternatives to an app.
• Do not use when: the user wants to install or download an app (no download or APK links), or needs Google Play data.
• Output: compact JSON. An app is identified by its Android package name (same in both stores). Ratings are 1-5 per store, installs is an approximate count, dates are YYYY-MM-DD (Gregorian), prices in Toman (0 = free).
• Machine-readable: server.json and the iran-mcp catalog.

Why

Cafe Bazaar and Myket are where most Iranian Android users get their apps, and neither offers a public API. Checking "is the Myket version of this app behind Bazaar, and how do users rate it in each store?" means opening both sites and reading two different pages. With iran-apps-mcp an agent answers it in one call and returns a short summary.

You: Is Telegram up to date on Myket compared with Cafe Bazaar?

Agent: calls ap_search(query="telegram") -> ap_compare(package="org.telegram.messenger")

It reads both versions, says which store has the newer one, and shows the rating difference.

What it can do

• Search apps and games in Cafe Bazaar, Myket or both, by Persian or English name
• Read one app: version, rating and rating count, installs, size, update date, developer, price and description
• Compare the same package in both stores side by side, with which store is newer and the rating difference
• List top or new apps per category (apps and games), or the store-wide trending or editorial list
• List categories of each store (slugs differ between the stores)
• Find similar apps the store itself shows as related
• Read-only by design: no login, no reviews, no downloads

Example prompts:

• "Search Cafe Bazaar and Myket for Snapp and show the ratings."
• "Compare the Digikala app on both stores: version, rating, installs."
• "What are the best new games on Myket this week?"
• "Top apps in the finance category on Cafe Bazaar."
• "Which apps do users also install along with Divar?"
• اپلیکیشن بله را در کافه‌بازار و مایکت جستجو کن و نسخه و امتیازش را مقایسه کن.
• بهترین بازی‌های جدید مایکت کدام‌اند؟
• برنامه‌های مشابه اسنپ در کافه‌بازار را نشان بده.

Quick start

You need uv. No API key or account.

claude mcp add iran-apps -- uvx iran-apps-mcp

{  "mcpServers": {    "iran-apps": { "command": "uvx", "args": ["iran-apps-mcp"] }  }}

{  "servers": {    "iran-apps": { "type": "stdio", "command": "uvx", "args": ["iran-apps-mcp"] }  }}

codex mcp add iran-apps -- uvx iran-apps-mcp

[mcp_servers.iran-apps]command = "uvx"args = ["iran-apps-mcp"]

{  "mcpServers": {    "iran-apps": { "command": "uvx", "args": ["iran-apps-mcp"] }  }}

Tools

An app is identified by its Android package name (for example com.whatsapp). Get it from ap_search.

All 6 tools are annotated readOnlyHint: true.

How it works

  AI agent  (Claude, Cursor, Copilot, ...)      │      │  MCP over stdio      ▼  iran-apps-mcp  (runs on your machine)      │      │  HTTPS      ├──────▶  api.cafebazaar.ir   JSON API of the Bazaar web app      └──────▶  myket.ir            page HTML (schema.org JSON-LD, facts table)

iran-apps-mcp runs locally and has no hosted server in between and no API key. Cafe Bazaar is read through the JSON requests its own web app uses; Myket has no JSON API, so its data is parsed from page HTML. Requests go out through a Chrome-impersonating client, at most 4 at a time with a little jitter, and a failed request is retried up to twice. It only reads.

Good to know

• Prices are in Toman, 0 means free. Both stores quote Rial internally; the server divides by 10.
• installs is approximate. Bazaar returns a range, Myket a text such as "32 million", so compare magnitudes, not exact numbers.
• Ratings are per store (1-5) and collected separately by each. A rating is omitted when the store has none.
• Paging: Bazaar returns 24 apps per page, Myket 20. Myket lists stop after about 4 pages.
• Categories differ between the stores; use ap_categories to get valid slugs for ap_top. Bazaar's game category list was found by probing and may be incomplete.
• Names: Bazaar names are often English, Myket's Persian. An app can be missing from one store (ap_compare gives null there); Google Play-only apps are in neither.
• Myket depends on page HTML, so a site redesign can break it. Bazaar uses its web app's JSON API, which is undocumented and can change.
• Network: both stores answered directly from Iran and through a foreign proxy exit when tested. If your network needs a proxy, set IRAN_APPS_MCP_PROXY.
• What it does not do: no download or APK links, no login, no reviews or comments, no purchases, no Google Play data. Developer descriptions and taglines are untrusted text.

FAQ

npx @modelcontextprotocol/inspector uvx iran-apps-mcp

Configuration

فارسی: سرور MCP کافه‌بازار و مایکت

claude mcp add iran-apps -- uvx iran-apps-mcp

Development

git clone https://github.com/sepehr071/iran-apps-mcp && cd iran-apps-mcpuv syncuv run ruff check . && uv run ruff format --check .uv run python -m pytest -q          # offline unit tests on recorded fixturesuv run python -m pytest -m live -q  # calls the real storesuv build

Each tool is a typed async function in src/iran_apps_mcp/tools.py with a docstring that tells the agent when to use it. Issues and PRs are welcome.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions publishes to PyPI.

Related servers

• iran-mcp: catalog of all Iranian-service MCP servers
• iran-downloads-mcp for Iranian download sites
• digikala-mcp for Digikala product search and prices
• torob-mcp for price comparison on Torob
• divar-mcp for Divar classified ads
• Listed on mcpfarsi.ir, the Persian MCP marketplace

Disclaimer

Unofficial and not affiliated with or endorsed by Cafe Bazaar or Myket. It is read-only and uses the web endpoints and pages of the two stores, which can change without notice. App data is informational.

Author

[Sepehr Radmard: open-source MCP servers for the Iranian web. LinkedIn: linkedin.com/in/sepehr-radmard]

Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.

License

MIT