namasha-mcp: Namasha (نماشا) Iranian video platform MCP server for AI agents
namasha-mcp is an unofficial, read-only MCP server that lets an AI agent search videos, read video details, comments and related videos, and browse channels and categories on Namasha (نماشا, namasha.com), an Iranian video-sharing platform.
Its 9 tools search videos, show a video (views, likes, comment count, duration, upload date, tags, channel), its comments and related videos, show a channel and its videos, list the home page's featured rows, and list the categories and their newest videos.
No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.
For AI agents · Quick start · Tools · Limits · فارسی
For AI agents
- What: unofficial MCP server (model context protocol) for namasha.com: video search, video details, comments, related videos, channel pages, featured rows and categories.
- Install:
uvx namasha-mcporclaude mcp add namasha -- uvx namasha-mcp. Transport: stdio. Needs uv (Python 3.10+). - Auth: none. Optional
NAMASHA_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 are not exposed, only page URLs.
- Tools: 9, all prefixed
nm_. Typical sequences:nm_search->nm_video/nm_channel;nm_channel->nm_channel_videos;nm_categories->nm_category_videos;nm_video->nm_comments/nm_related. - Use when: the user wants to find Persian videos on Namasha, asks how many views or likes a video has, wants a channel's videos, or wants to browse a category or the home page picks.
- Output: compact JSON. Duration is seconds. Lists carry title, duration, channel and a relative age text in Persian; only
nm_videohas views, likes and the exact upload date. Titles and comments are Persian.
Quick start
You need uv. No API key or account.
Claude Code:
claude mcp add namasha -- uvx namasha-mcp
Claude Desktop, Cursor, VS Code and other clients:
{
"mcpServers": {
"namasha": { "command": "uvx", "args": ["namasha-mcp"] }
}
}
Example prompts:
- "Search Namasha for Python tutorials."
- "How many views does the Namasha video yt6ef2FC have?"
- "List the newest videos in the music category on Namasha."
- در نماشا دنبال ویدیوهای آموزش پایتون بگرد.
- آخرین ویدیوهای کانال پویاکام را نشان بده.
Real answers (18 Nov 2026): nm_search(query="آموزش پایتون") returned 60 videos on page 1, the first lasting 116 seconds, then 127 and 838 seconds. nm_video(video="yt6ef2FC") returned 286,336 views, 44 likes and a duration of 270 seconds.
Tools
| Tool | What it returns |
|---|---|
nm_search |
Videos matching a text, 60 per page |
nm_video |
One video: title, description, views, likes, comment count, duration, upload date, tags, channel |
nm_related |
Videos Namasha suggests next to a video (page 1 about 12, later pages 20 each) |
nm_comments |
The public comments of a video: text, author, age, likes, replies |
nm_channel |
A channel: name, verified flag, description, creation date, links |
nm_channel_videos |
A channel's videos, newest first, 60 per page |
nm_featured |
The videos on the home page: editors' picks or the special row |
nm_categories |
Namasha's video categories with the slug the category tool takes |
nm_category_videos |
The newest videos of a category, 60 per page |
Limits
- Namasha has no JSON API, so the server reads the HTML pages. A site redesign can break parsing until the server is updated.
- Views come only from the video page's structured data; they are not shown on the page itself. List results have no view counts.
- Lists show a relative age in Persian (for example "2 سال پیش"), not an exact date. Namasha has no view-based trending list and no channel follower counts.
- Few videos have comments. Comment paging was not seen (at most 5 comments were found), so it is unverified for videos with many comments.
- The home "featured" row rotates on every load. Home rows other than featured and special are not exposed.
- Namasha answered both Iranian and foreign networks in testing; if yours is blocked, set
NAMASHA_MCP_PROXY. The server ignores system proxy variables on purpose.
How it works
Namasha has no public API documentation. The pages and the small AJAX endpoints behind them (comments, suggested videos) were mapped by watching namasha.com in Chrome, and every tool was then checked in Chrome against the real rendered pages on 18 Nov 2026. The server fetches those same public pages through a Chrome-impersonating HTTP client, with a short cache and at most two requests at a time.
فارسی
namasha-mcp یک سرور MCP غیررسمی و فقطخواندنی برای نماشا (namasha.com) است. با آن یک عامل هوش مصنوعی میتواند ویدیوها را جستوجو کند، جزئیات ویدیو (بازدید، لایک، مدت، برچسبها، کانال)، نظرات و ویدیوهای مرتبط را بخواند، کانال و ویدیوهایش را ببیند و دستهبندیها و ویدیوهای منتخب صفحهٔ اصلی را فهرست کند. بدون حساب کاربری و کلید API کار میکند. نصب در Claude Code:
claude mcp add namasha -- uvx namasha-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 namasha.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 Namasha. It is read-only and uses the public pages of namasha.com, which can change without notice.
Author
Built and maintained by Sepehr Radmard (سپهر رادمرد). LinkedIn · GitHub · more servers in iran-mcp.
مجوز استفاده (License)
استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیتهاب با سپهر رادمرد تماس بگیرید. متن کامل: PolyForm Noncommercial 1.0.0.
Free for personal and non-commercial use under the PolyForm Noncommercial License 1.0.0. Using it in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on LinkedIn or GitHub.
Metadata
Release files for namasha-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)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| namasha_mcp-0.1.0.tar.gz | 445.2 kB | With provenance | Details for namasha_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| namasha_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for namasha_mcp-0.1.0-py3-none-any.whl |
Total release size: 463.1 kB
Release files / namasha_mcp-0.1.0.tar.gz
| Download URL | namasha_mcp-0.1.0.tar.gz |
|---|---|
| Size | 445.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
60469bb8075450c1234e8f90288251911b0dcf3ffbd106734c03d84aa8864afe
|
|
BLAKE2b-256 checksum How to use checksums |
b0b9507606607fac6a0672afaf17a5de9a530d42946743901b2b4a0f3b63d7a8
|
| 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 18, 2026.
Transparency logRelease files / namasha_mcp-0.1.0-py3-none-any.whl
| Download URL | namasha_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 17.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b867076d1bfc6b7785b294609db4df4e6bc0c544349f6f08d18f125a65b0ed5
|
|
BLAKE2b-256 checksum How to use checksums |
3209e7c6352b5b9d481f893ef2b60ffe259d259f4ce11f75763ab14468803e3a
|
| 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 18, 2026.
Transparency logSecurity for namasha-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.
Attestation for namasha_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 18, 2026.
Transparency logA 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.