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.

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 Code

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

Claude Desktop

Settings → Developer → Edit Config, then add:

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

Cursor

Add the Claude Desktop block above to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

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

Codex CLI

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

Or in ~/.codex/config.toml:

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

Gemini CLI

Add to ~/.gemini/settings.json:

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

Windsurf

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

Anything else

It is a standard stdio MCP server: run uvx iran-downloads-mcp, or pip install iran-downloads-mcp and run 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

Is there an MCP server for Soft98, P30Download or Downloadly?

None of these sites documents a public API. iran-downloads-mcp is an unofficial MCP server with 4 read-only tools that reads their public pages, feeds and (for VGDL) WordPress REST posts and returns compact JSON for AI agents.

Can it download a file or give me a direct link?

No, on purpose. The sites gate links behind tokens, countdowns and ads, and many files are cracked or repacked copies. The server stays a search index; each result carries the item page url.

Does it work outside Iran?

It depends on the site and your exit. From a Turkish proxy exit Soft98, P30Download and Downloadly answered in testing, but VGDL returned a bot-check page (the tool reports it). If a site blocks you, try a direct connection or IRAN_DOWNLOADS_MCP_PROXY with an Iranian exit.

Why does dl_latest have no Soft98 results?

Soft98's listing pages hide item links behind script keys, which this server does not decode. Soft98 is available through dl_search and dl_item.

Why is the file size missing for some items?

Soft98 shows no size outside its download data, and VGDL pages mix sizes with crack and install notes, so those are not read. P30Download and Downloadly items include size when the page has it.

Are the listed programs legal and safe?

The server cannot tell. Many listings on these sites are cracked, repacked or redistributed. Check each programme's licence and follow the law where you live.

How do I use it with Claude, Cursor or Copilot?

Add the server with claude mcp add iran-downloads -- uvx iran-downloads-mcp, or use the matching config in Quick start, then ask in plain language, in Persian or English.

How do I debug what the agent sees?

npx @modelcontextprotocol/inspector uvx iran-downloads-mcp

Configuration

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

iran-downloads-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای جست‌وجوی فراداده (نام، نسخه، حجم، دسته، تاریخ، توضیح کوتاه، سیستم مورد نیاز و پیوند صفحهٔ آیتم) در سافت۹۸ (Soft98)، پی‌سی دانلود (P30Download)، دانلودلی (Downloadly) و ویجی دی ال (VGDL) است. به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) کمک می‌کند آخرین نسخه و مشخصات یک برنامه یا بازی را پیدا کند.

چه کارهایی می‌کند

• جست‌وجوی نام نرم‌افزار یا بازی در چهار سایت با یک درخواست (نام لاتین بهتر جواب می‌دهد).
• جدیدترین آپلودها در پی‌سی دانلود، دانلودلی و ویجی دی ال (سافت۹۸ فهرست جدیدترین‌ها ندارد).
• جزئیات آیتم: نسخه، حجم، دسته، تاریخ، توضیحات و سیستم مورد نیاز، تا جایی که سایت منتشر کرده باشد.

نکته‌ها

• فقط فراداده برمی‌گرداند: فایلی دانلود یا ذخیره نمی‌کند، پیوند فایل، گذرواژه یا کرک برنمی‌گرداند و پیوندهای قفل‌شده را دور نمی‌زند.
• بسیاری از آیتم‌های این سایت‌ها کرک‌شده یا ریپک هستند؛ بررسی مجوز نرم‌افزارها و رعایت قانون با خود شماست.
• تاریخ‌های شمسی سافت۹۸ به میلادی تبدیل می‌شوند.
• ویجی دی ال فقط عنوان، دسته، تاریخ و خلاصه می‌دهد.
• اگر سایتی پاسخ نداد، همان سایت در بخش errors می‌آید و بقیه جواب می‌دهند. در صورت نیاز متغیر IRAN_DOWNLOADS_MCP_PROXY را روی یک پراکسی HTTP با خروجی ایران بگذارید.
• کلید API لازم نیست و روی سیستم خود شما اجرا می‌شود.

نصب (اول uv را نصب کنید). در Claude Code:

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

در Claude Desktop، Cursor و بقیه برنامه‌ها همان تنظیم بخش Quick start را بگذارید.

نمونه پرسش‌ها

• «آخرین نسخه گوگل کروم را در سایت‌های دانلود ایرانی پیدا کن.»
• «امروز چه بازی‌هایی در ویجی دی ال اضافه شده؟»
• «سیستم مورد نیاز فتوشاپ در دانلودلی چیست؟»

Development

git clone https://github.com/sepehr071/iran-downloads-mcp && cd iran-downloads-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests
uv run python -m pytest -m live -q  # calls the real sites
uv 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

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

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