Skip to main content
aparat-mcp: unofficial Aparat (آپارات) MCP server that searches Iranian videos and channels, reads comments and lists trending videos for Claude, Cursor and Copilot

aparat-mcp: Aparat (آپارات) Iranian video platform MCP server for AI agents

aparat-mcp is an unofficial, read-only MCP server that lets an AI agent search videos and channels, read video details and comments, and see what is trending on Aparat (آپارات, aparat.com), the biggest Iranian video platform.
Its 8 tools search videos and channels, show a video (views, likes, duration, tags, category, channel, publish date), its comments and related videos, show a channel and its newest or most viewed videos, and list trending videos overall or per category.
No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.

PyPI Python CI License: MIT

For AI agents · Quick start · Tools · Limits · فارسی


For AI agents

  • What: unofficial MCP server (model context protocol) for aparat.com: video and channel search, video details, comments, related videos, channel pages and trending feeds.
  • Install: uvx aparat-mcp or claude mcp add aparat -- uvx aparat-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional APARAT_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
  • Access: read-only. It cannot log in, upload, comment, like or follow. Video files and stream links are not exposed, only page URLs.
  • Tools: 8, all prefixed apr_. Typical sequences: apr_search -> apr_video / apr_channel; apr_channel -> apr_channel_videos; apr_categories -> apr_trending; apr_video -> apr_comments / apr_related.
  • Use when: the user asks what is popular on Aparat, wants to find Persian videos or a creator's channel, asks how many views, likes or followers something has, or wants to read what viewers say under a video.
  • Output: compact JSON. Views are counts, duration is seconds, dates are Gregorian. Titles and comments are Persian.

Quick start

You need uv. No API key or account.

Claude Code:

claude mcp add aparat -- uvx aparat-mcp

Claude Desktop, Cursor, VS Code and other clients:

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

Example prompts:

  • "Search Aparat for Persian cooking videos."
  • "What are the most viewed videos of the channel macharta?"
  • "What is trending in music on Aparat?"
  • نظرات این ویدیوی آپارات را بخوان.
  • پربازدیدترین ویدیوهای کانال ماچارتا کدام‌اند؟

Real answer (17 Nov 2026): apr_channel_videos(channel="macharta", sort="top") returned 2,118,476 views for the top video of that channel, then 1,650,691 and 1,488,902.

Tools

Tool What it returns
apr_search Videos and channels matching a text, in relevance order, paged with next
apr_video One video: title, description, views, likes, comments, duration, tags, category, channel, publish date
apr_comments Top comments of a video, 10 per page
apr_related Videos Aparat recommends next to a video (about 10)
apr_channel A channel: name, followers, video count, total views, description, start date
apr_channel_videos A channel's videos, newest first or most viewed, 10 per page
apr_categories The category names Aparat's trending tabs use
apr_trending Trending videos overall or in one category (up to 40)

Limits

  • Counters on Aparat change by the second, so a view count read twice a minute apart can differ slightly.
  • Channel video lists and comments come 10 per page; search about 40 per page. Use the next token or page for more.
  • Overall trending (the site's "hottest" row) is not shown on Aparat's logged-out home page, so it was checked against the API only, not against the rendered page. Category trending was checked against the page.
  • Stream links, downloads, live streams and anything behind a login (history, subscriptions, uploads) are not covered.
  • Aparat answers both Iranian and foreign networks in testing; if your network is blocked, set APARAT_MCP_PROXY. The server ignores system proxy variables on purpose.

How it works

Aparat has no public API documentation. The endpoints were mapped by watching aparat.com in Chrome, and every tool was then checked in Chrome against the real rendered pages (search, video, comments, channel, channel videos, categories, trending, related) on 16 Nov 2026. The server calls those same public endpoints through a Chrome-impersonating HTTP client, with a short cache and at most two requests at a time.

فارسی

aparat-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای آپارات (aparat.com) است. با آن یک عامل هوش مصنوعی می‌تواند ویدیوها و کانال‌ها را جست‌وجو کند، جزئیات ویدیو (بازدید، لایک، مدت، برچسب‌ها، دسته‌بندی)، نظرات و ویدیوهای مرتبط را بخواند، کانال و پربازدیدترین ویدیوهایش را ببیند و ویدیوهای پربازدید و داغ هر دسته را فهرست کند. بدون حساب کاربری و کلید API کار می‌کند. نصب در Claude Code:

claude mcp add aparat -- uvx aparat-mcp

Development

uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline tests on recorded fixtures
uv run python -m pytest -m live -q  # live calls to aparat.com

Releases: bump the version in pyproject.toml and server.json, run uv lock, then push a v* tag; GitHub Actions publishes to PyPI.

Disclaimer

Unofficial and not affiliated with or endorsed by Aparat. It is read-only and uses the public pages and API of aparat.com, which can change without notice.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). LinkedIn · GitHub · more servers in iran-mcp.

License

MIT

Metadata

Release files for aparat-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aparat-mcp 0.1.0
File Size Uploaded Provenance Actions
aparat_mcp-0.1.0.tar.gz 777.0 kB With provenance Details for aparat_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aparat-mcp 0.1.0
File Interpreter ABI Platform Actions
aparat_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for aparat_mcp-0.1.0-py3-none-any.whl

Total release size: 792.4 kB

Release files / aparat_mcp-0.1.0.tar.gz

Download URL aparat_mcp-0.1.0.tar.gz
Size 777.0 kB
Tags Source
SHA-256 checksum
How to use checksums
d4475f6917b93136c5166a049fa414da87b527ad26c8ba91b9c97996d7f896ad
BLAKE2b-256 checksum
How to use checksums
ba8539d28ea100f9b703b89a9a0e875ae9169097e3d20c6c3956194120857260
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / aparat_mcp-0.1.0-py3-none-any.whl

Download URL aparat_mcp-0.1.0-py3-none-any.whl
Size 15.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a6061d58f91e312dcf91a234b5ad752fa44b29e3deee922a940cac4fa4d7f751
BLAKE2b-256 checksum
How to use checksums
789f8d8aa697163f35fe3d0ee225f756f6cb16ba1118e03b1832183d828db829
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for aparat-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aparat_mcp-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page