Skip to main content
namasha-mcp: unofficial Namasha (نماشا) MCP server that searches Iranian videos, reads channels and comments and browses categories for Claude, Cursor and Copilot

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.

PyPI Python CI License: PolyForm Noncommercial

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-mcp or claude 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_video has 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.

فارسی

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)

استفادهٔ شخصی و غیرتجاری رایگان است؛ برای استفادهٔ تجاری با سپهر رادمرد تماس بگیرید. Free for personal and non-commercial use; commercial use needs a 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.1

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

Source distribution (sdist)

Source distribution for namasha-mcp 0.1.1
File Size Uploaded Provenance Actions
namasha_mcp-0.1.1.tar.gz 445.0 kB With provenance Details for namasha_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for namasha-mcp 0.1.1
File Interpreter ABI Platform Actions
namasha_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for namasha_mcp-0.1.1-py3-none-any.whl

Total release size: 462.7 kB

Release files / namasha_mcp-0.1.1.tar.gz

Download URL namasha_mcp-0.1.1.tar.gz
Size 445.0 kB
Tags Source
SHA-256 checksum
How to use checksums
7c7be46c530a85ecdfaa8d99156ddd43a20e36afbe6573e43789606e888b7239
BLAKE2b-256 checksum
How to use checksums
2e5ee4c2d2177c0c09766250302664802d05d2bef63db1a4794b766cf564a020
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 log

Release files / namasha_mcp-0.1.1-py3-none-any.whl

Download URL namasha_mcp-0.1.1-py3-none-any.whl
Size 17.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2a684d7ff51964754f78740a6b7ac34e1201ae1ce178793d510ebd7279c451e1
BLAKE2b-256 checksum
How to use checksums
ec2cd42074e0810d44cb7d85b069dfb58ede289b47fa2b35ee745166f7daec33
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 log

Security for namasha-mcp 0.1.1

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 namasha_mcp-0.1.1.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 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.1 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