Iran Apps MCP server

<!-- mcp-name: io.github.sepehr071/iran-apps-mcp -->

iran-apps-mcp: Cafe Bazaar and Myket MCP server for AI agents

Let your AI agent look up apps on the Iranian Android stores. An unofficial, read-only MCP server for Cafe Bazaar (کافه&zwnj;بازار) and Myket (مایکت): search apps and games, compare one package across both stores, and list top or new apps, from Claude, Cursor or Copilot.

For AI agents · Quick start · What it can do · Tools · FAQ · فارسی

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 IRANAPPSMCP_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: apsearch (get the package name) -> apcompare or apapp -> apsimilar. For lists, call apcategories 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 apsearch(query="telegram") -> apcompare(package="org.telegram.messenger")

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

What it can do

Shortened. The full README is on GitHub.