Skip to main content
Glama

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.

Related MCP server: YouTube MCP Server

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)

استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیت‌هاب با سپهر رادمرد تماس بگیرید. متن کامل: 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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to search videos, read channels, browse playlists, fetch comments, and get transcripts from YouTube using the YouTube Data API v3 and InnerTube API for captions.
      2
      GPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to search videos, retrieve transcripts and metadata, analyze channels, and access trending and engagement analytics for YouTube content.
      18 npm
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search products on Iran's marketplace of independent shops with price, category, shipping and discount filters, find the cheapest in-stock offers, and read product details, shops, categories and customer reviews. It is read-only and needs no authentication, so it can be used straight from Claude, Cursor or Copilot.
      7
      144 PyPI
      PolyForm Noncommercial 1.0.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Iranian places, read place details, reviews, photos and menus, find nearby places, reverse geocode coordinates, check air quality, and get car, motorcycle, bicycle, walking or bus/metro directions, travel times and Tehran traffic-zone status without an API key.
      11
      144 PyPI
      PolyForm Noncommercial 1.0.0