iran-apps-mcp
Advanced tools
Unofficial read-only MCP server for Iranian Android app stores Cafe Bazaar and Myket: search apps and games, compare versions and ratings across stores, top and new lists.
Let your AI agent look up apps on the Iranian Android stores.
An unofficial, read-only MCP server for Cafe Bazaar (کافهبازار) 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 · فارسی
uvx iran-apps-mcp or claude mcp add iran-apps -- uvx iran-apps-mcp. Transport: stdio. Needs uv (Python 3.10+).IRAN_APPS_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.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.installs is an approximate count, dates are YYYY-MM-DD (Gregorian), prices in Toman (0 = free).server.json and the iran-mcp catalog.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.
Example prompts:
You need uv. No API key or account.
claude mcp add iran-apps -- uvx iran-apps-mcp
Settings → Developer → Edit Config, then add:
{
"mcpServers": {
"iran-apps": { "command": "uvx", "args": ["iran-apps-mcp"] }
}
}
Add the Claude Desktop block above to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": {
"iran-apps": { "type": "stdio", "command": "uvx", "args": ["iran-apps-mcp"] }
}
}
codex mcp add iran-apps -- uvx iran-apps-mcp
Or in ~/.codex/config.toml:
[mcp_servers.iran-apps]
command = "uvx"
args = ["iran-apps-mcp"]
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"iran-apps": { "command": "uvx", "args": ["iran-apps-mcp"] }
}
}
Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
It is a standard stdio MCP server: run uvx iran-apps-mcp, or pip install iran-apps-mcp and run iran-apps-mcp.
An app is identified by its Android package name (for example com.whatsapp). Get it from ap_search.
| Tool | What it does |
|---|---|
ap_search | Search Cafe Bazaar and/or Myket for apps and games by name; returns package names, ratings and store URLs |
ap_app | Get one app's metadata from one store: version, rating and rating count, installs, size, update date, developer, price, description |
ap_compare | Compare one package across Cafe Bazaar and Myket: version, rating, rating count, installs, size, update date, price |
ap_top | List the top ('best') or newest ('new') apps or games of a store, per category or store-wide |
ap_categories | List the category slugs of a store for apps and games, to pass as ap_top category |
ap_similar | List apps the store shows as related to one app: Bazaar gives three groups (related, others also installed, similar), Myket one |
All 6 tools are annotated readOnlyHint: true.
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.
installs is approximate. Bazaar returns a range, Myket a text such as "32 million", so compare magnitudes, not exact numbers.ap_categories to get valid slugs for ap_top. Bazaar's game category list was found by probing and may be incomplete.ap_compare gives null there); Google Play-only apps are in neither.IRAN_APPS_MCP_PROXY.Neither store documents a public API. iran-apps-mcp is an unofficial MCP server with 6 read-only tools that reads
Cafe Bazaar through its web app's API and Myket from its pages, and returns compact JSON for AI agents.
Add the server with claude mcp add iran-apps -- uvx iran-apps-mcp, or use the matching config in
Quick start, then ask in plain language, in Persian or English.
No. It returns metadata and the store page URL only.
Find the package name with ap_search, then call ap_compare. It shows both versions, which store is newer and the
rating difference.
Toman. Both stores quote Rial internally and the server converts. 0 means free.
The stores do not publish exact counts: Bazaar returns a range and Myket a rounded text. The server gives an approximate integer.
No. It only sees what is listed on Cafe Bazaar and Myket.
Usually not. Both stores answered directly and through a foreign exit when tested. If your network blocks them, set
IRAN_APPS_MCP_PROXY to an HTTP proxy. System proxy variables are ignored on purpose.
npx @modelcontextprotocol/inspector uvx iran-apps-mcp
| Variable | Default | Meaning |
|---|---|---|
IRAN_APPS_MCP_PROXY | unset | Optional HTTP proxy URL for cafebazaar.ir and myket.ir; system proxy settings are ignored. A comma-separated list is tried in turn |
iran-apps-mcp یک سرور MCP غیررسمی و فقطخواندنی برای دو فروشگاه برنامهٔ اندروید ایران، کافهبازار و مایکت، است. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه میدهد برنامه و بازی را در هر دو فروشگاه جستجو کند.
چه کارهایی میکند
نکتهها
IRAN_APPS_MCP_PROXY استفاده کنید.نصب (اول uv را نصب کنید). در Claude Code:
claude mcp add iran-apps -- uvx iran-apps-mcp
در Claude Desktop، Cursor و بقیه برنامهها همان تنظیم بخش Quick start را بگذارید.
نمونه پرسشها
git clone https://github.com/sepehr071/iran-apps-mcp && cd iran-apps-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q # offline unit tests on recorded fixtures
uv run python -m pytest -m live -q # calls the real stores
uv 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.
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.
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.
FAQs
Unofficial read-only MCP server for Iranian Android app stores Cafe Bazaar and Myket: search apps and games, compare versions and ratings across stores, top and new lists.
We found that iran-apps-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Socket uncovered secret-stealing workflows that ran in LiteLLM’s GitHub repository 11 days before the supply chain attack on PyPI and Docker.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.