Iran Software Downloads

iran-downloads-mcp: Iranian software and game download sites MCP server for AI agents

Let your AI agent look up software and games (دانلود نرم‌افزار و بازی) on Soft98, P30Download, Downloadly and VGDL.
An unofficial, read-only MCP server that searches the public pages of Soft98, P30Download, Downloadly and VGDL and returns metadata only: name, version, size, category, date, a short description, system requirements and the link to the item page.

[PyPI] [Python] [CI] [MCP Registry] [License: MIT] [mcpfarsi]

[Install in VS Code]

Metadata search only. This server never downloads or saves files, never returns file links, and does not resolve or bypass gated or tokenised download links. It returns no passwords and no crack or activation notes. Many listings on these sites are cracked, repacked or otherwise redistributed software. You are responsible for checking the licence of whatever you install and for following the law where you live.

For AI agents · Why · What it can do · Quick start · Tools · Sources · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related servers

For AI agents

• What: unofficial MCP server (model context protocol) for metadata search on Soft98 (soft98.ir), P30Download (p30download.ir), Downloadly (downloadly.ir) and VGDL (vgdl.ir). Persian and English text.
• Install: uvx iran-downloads-mcp or claude mcp add iran-downloads -- uvx iran-downloads-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional IRAN_DOWNLOADS_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
• Access: read-only. No login, no downloads, so no confirmation is needed before calling any tool.
• Tools: 4, all prefixed dl_: dl_list_sources, dl_search, dl_latest, dl_item. Typical sequence: dl_list_sources (source ids and category slugs) -> dl_search or dl_latest -> dl_item with a result url.
• Use when: the user wants to find an app or game by name, see what is new, or check version, size and system requirements before opening the item page.
• Do not use when: the user wants the file itself, a direct link, a password, or a crack. None of that is returned; send them to the item page url and remind them to check the licence.
• Output: compact JSON. Dates are ISO (UTC where a time is shown); Soft98's Jalali dates are converted. Summaries are cut to 120 characters, descriptions to 600. Null and empty fields are omitted. Replies stay under ~15 KB (per_source max 5). A failing source is listed under errors while the others still answer. Pages are cached for 3 minutes.
• Machine-readable: server.json and the iran-mcp catalog.

Why

Iranian download sites are the first stop for many people looking for an app, a game or a Persian-language mirror, but each one has its own layout, search and category tree. Asking "what is the latest version of Google Chrome, and how big is it?" or "which games were uploaded today?" means opening several sites. With iran-downloads-mcp an agent runs one search across all four sources and gets short, comparable records instead of full web pages.

You: Is there a new version of VLC, and what does it need to run?

Agent: calls dl_search(query="VLC") -> dl_item(url=...)

It lists the matching entries per site with their versions, then reads one item page for size and system requirements, and points you to the page for the actual download.

Every reply is trimmed to stay under about 15 KB, so it does not flood the agent's context.

What it can do

• Search by name across Soft98, P30Download, Downloadly and VGDL in one call, with up to 5 results per source
• See the newest uploads merged by date, optionally limited to sources and a category (Soft98 has no latest listing)
• Read item details: name, version, size, category, date, description and system requirements, where the site publishes them
• List sources with their ids, whether they have a latest listing, and category slugs
• Read-only by design: no downloads, no file links, no passwords, no crack notes

Example prompts:

• "Search for Google Chrome on the Iranian download sites and compare versions."
• "What was uploaded to P30Download and Downloadly today?"
• "What are the system requirements of Adobe Photoshop on Downloadly?"
• "Newest PC games on VGDL."
• آخرین نسخه نرم‌افزار ویندوز ۱۱ یا فتوشاپ در سافت۹۸ چیست؟
• جدیدترین بازی‌های اضافه‌شده به پی‌سی دانلود را نشان بده.
• حجم و سیستم مورد نیاز این برنامه در دانلودلی چقدر است؟

Quick start

You need uv. No API key or account.

claude mcp add iran-downloads -- uvx iran-downloads-mcp

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

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

codex mcp add iran-downloads -- uvx iran-downloads-mcp

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

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

Tools

All 4 tools are annotated readOnlyHint: true.

Sources

Titles carry the version where the site puts it there (for example Google Chrome 155.0.8059.85); dl_item returns a best-effort version.

How it works

  AI agent  (Claude, Cursor, Copilot, ...)      │      │  MCP over stdio      ▼  iran-downloads-mcp  (runs on your machine)      │      │  HTTPS, GET only      ├──────▶  soft98.ir      ├──────▶  p30download.ir      ├──────▶  downloadly.ir      └──────▶  vgdl.ir

iran-downloads-mcp runs locally and reads the public pages, RSS feeds and WordPress REST posts of the four sites. There is no hosted server in between and no API key. Requests go out through a Chrome-impersonating client, at most 4 at a time with a little jitter; answers are cached for 3 minutes, failed GETs are retried, and only these four hosts over HTTPS are allowed. It does not read or decode the download lists or the keys that hide links on the sites.

Good to know

• Metadata only. No file downloads, no file or mirror links, no passwords, no crack or activation notes. Sentences mentioning those are dropped from summaries, descriptions and requirements.
• Soft98 supports search only, and its item pages have no file size. dl_latest skips it.
• VGDL returns title, category, date and excerpt only. Its listings are repacks, so the licence caveat applies in full.
• Dates: Soft98's Jalali dates are converted to Gregorian ISO dates; times, where shown, are UTC.
• Versions are parsed from the title when the page has no version field, so treat them as best effort.
• Reply caps: at most 5 results per source per call (per_source), summaries 120 characters, descriptions 600, about 15 KB per reply.
• Partial failures: a source that fails (blocked, down, bot-check page) appears under errors and the others still answer.
• Network: in testing the four sites answered direct connections from Iran. Through a Turkish proxy exit Soft98, P30Download and Downloadly answered, while VGDL returned a bot-check page instead of JSON. Prefer a direct connection, or set IRAN_DOWNLOADS_MCP_PROXY with an Iranian exit. System proxy variables are ignored on purpose.
• Latin names work best for search.
• What it does not do: no downloading, no link resolving, no licence checks, no other download sites.

FAQ

npx @modelcontextprotocol/inspector uvx iran-downloads-mcp

Configuration

فارسی: سرور MCP سایت‌های دانلود نرم‌افزار و بازی

claude mcp add iran-downloads -- uvx iran-downloads-mcp

Development

git clone https://github.com/sepehr071/iran-downloads-mcp && cd iran-downloads-mcpuv syncuv run ruff check . && uv run ruff format --check .uv run python -m pytest -q          # offline unit testsuv run python -m pytest -m live -q  # calls the real sitesuv build

All tools live in src/iran_downloads_mcp/downloads.py; each is a typed async function 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-apps-mcp for Iranian app stores
• iran-news-mcp for Iranian news
• torob-mcp for price comparison on Torob
• digikala-mcp for products on Digikala
• Listed on mcpfarsi.ir, the Persian MCP marketplace

Disclaimer

Unofficial and not affiliated with or endorsed by Soft98, P30Download, Downloadly or VGDL. It is read-only, returns metadata and item page links only, and uses public pages that can change without notice. Many listings on these sites are cracked or repacked software: check licences yourself.

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