iran-downloads-mcp
This is a read-only MCP server for searching metadata across four Iranian software and game download sites: Soft98, P30Download, Downloadly, and VGDL.
List sources with
dl_list_sourcesto get valid source ids and category slugs.Search by name across all sites with
dl_search, returning titles, item page URLs, categories, dates, and short summaries.See latest uploads with
dl_latest, merged and sorted by date; Soft98 has no latest listing.Read item details with
dl_item, including name, version, size where published, category, date, description, and system requirements.Work in Persian or English; Latin names generally search best.
Stay safe by design: no downloads, no file links, no passwords, no crack notes; only metadata and item page URLs are returned.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iran-downloads-mcp Search Soft98 and Downloadly for the latest VLC version and system requirements"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcporclaude 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_searchordl_latest->dl_itemwith a resulturl.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
urland 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_sourcemax 5). A failing source is listed undererrorswhile the others still answer. Pages are cached for 3 minutes.Machine-readable:
server.jsonand the iran-mcp catalog.
Related MCP server: iran-apps-mcp
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-mcpSettings → Developer → Edit Config, then add:
{
"mcpServers": {
"iran-downloads": { "command": "uvx", "args": ["iran-downloads-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-downloads": { "type": "stdio", "command": "uvx", "args": ["iran-downloads-mcp"] }
}
}codex mcp add iran-downloads -- uvx iran-downloads-mcpOr in ~/.codex/config.toml:
[mcp_servers.iran-downloads]
command = "uvx"
args = ["iran-downloads-mcp"]Add to ~/.gemini/settings.json:
{
"mcpServers": {
"iran-downloads": { "command": "uvx", "args": ["iran-downloads-mcp"] }
}
}Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
It is a standard stdio MCP server: run uvx iran-downloads-mcp, or pip install iran-downloads-mcp and run iran-downloads-mcp.
Tools
Tool | What it does |
| List the four download-site sources and their latest-listing categories; call this first for valid ids |
| Search the download sites by name and return metadata (title, item page url, category, date, short summary); takes |
| Return the newest uploads of the download sites, merged and sorted by date; takes |
| Return the details of one download item from its page |
All 4 tools are annotated readOnlyHint: true.
Sources
id | Site | Search | Latest | Item details |
| Soft98 | site search (8 per page) | no: listing pages hide item links behind script keys | title, version, category, date, description, requirements; no size |
| P30Download |
| RSS per section: software, game, tutorial, graphic, console | adds size, publisher, release date |
| Downloadly |
| home or category archive: software, mobile, multimedia, video-tutorials | adds size and requirements |
| VGDL | WordPress REST | REST posts, optional category: game, software, mobile | title, category, date, excerpt only (size and requirements sit next to crack and repack notes, so they are not read) |
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.iriran-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_latestskips 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
errorsand 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_PROXYwith 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
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.
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.
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.
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.
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.
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.
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.
npx @modelcontextprotocol/inspector uvx iran-downloads-mcpConfiguration
Variable | Default | Meaning |
| unset | Optional HTTP proxy URL. System proxy settings are ignored. A comma-separated list is used one at a time: the next proxy takes over when one is blocked or cannot connect |
فارسی: سرور 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 buildAll 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
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
Available Tools
4 toolsdl_itemDownload item detailsARead-onlyIdempotent
Return the details of one download item: name, version, size, category, date, description and system requirements.
Fields a site does not publish are omitted (soft98 has no size; vgdl has neither size nor requirements).
Inputs: url (required).
dl_latestLatest downloadsARead-onlyIdempotent
Return the newest uploads of the download sites (soft98 has no latest listing), merged and sorted by date.
Sources that failed or lack the category are listed under errors.
Inputs: sources, category, per_source.
dl_list_sourcesList download sourcesARead-onlyIdempotent
List the four download-site sources and their latest-listing categories; call this first for valid ids.
Inputs: no named parameters.
dl_searchSearch download sitesARead-onlyIdempotent
Search the download sites by name and return metadata (title, item page url, category, date, short summary).
Grouped by source, each site's own relevance order. A failing source is listed under errors.
Inputs: query (required), page, sources, per_source.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool covers a distinct stage of the workflow: discovery (dl_list_sources), name lookup (dl_search), recency browsing (dl_latest), and detail retrieval (dl_item). The only mild overlap is between dl_search and dl_latest, since both return lists of items, but the descriptions clearly differentiate relevance-ordered name matching from date-sorted newest uploads.
All four names share a predictable dl_ prefix and are readable at a glance. Minor inconsistency in that dl_latest and dl_item are noun/adjective-only rather than verb_noun like dl_list_sources and dl_search, but the pattern is still coherent.
Four tools is a tight, well-scoped surface for a metadata-browsing server: list sources, search, browse latest, and inspect one item. Each tool earns its place with no redundant entries.
The browse lifecycle (sources -> search/latest -> item detail) is fully covered, with error reporting per source. Gaps exist around pagination of search results, explicit category-scoped browsing, and any way to resolve actual download links, though agents can work around the first two via search.
Maintenance
Related MCP Connectors
Read-only search of 2,189 AI agent tools (MCP servers, x402 APIs) with daily automated trust scores.
Free, source-checked directory of AI agent tools, MCP servers and skills, with read-only search.
Search a curated directory of agent tools, MCP servers, APIs, protocols and skills. No auth.
Read-only search over 2,065+ AI agent tools and 276 MCP servers. Free, no sign-up needed.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI agents to compare prices across Iranian online and in-person shops, inspect each seller's offer with warranty and installment details, review roughly a year of price history, score deals, and find the cheapest shop for a whole basket. It is read-only, requires no account or API key, and runs locally for Claude, Cursor or Copilot.26401 PyPI1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search Iranian Android app stores, Cafe Bazaar and Myket, and retrieve app metadata such as version, rating, installs, size, update date and price, plus side-by-side comparisons of the same package across both stores and per-category top or newest listings. It is read-only and metadata only, returning compact JSON with store page URLs and supporting both Persian and English queries.6109 PyPI3MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search Iranian electronics products, read full spec tables, compare models side by side, and check shop offers and price history in Toman. It also covers category filtering, spec-based ranking, and Zoomit reviews, articles and buying guides, all read-only and without an API key.12174 PyPI3MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search and browse an Iranian online pharmacy's catalog read-only, covering prices per variant, ingredients, dosage, warnings, user questions and reviews, product comparisons and alternatives, plus health magazine articles. No API key or account is required.12213 PyPI2MIT