namasha-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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.
Related MCP server: YouTube MCP Server
Quick start
You need uv. No API key or account.
Claude Code:
claude mcp add namasha -- uvx namasha-mcpClaude 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 |
| Videos matching a text, 60 per page |
| One video: title, description, views, likes, comment count, duration, upload date, tags, channel |
| Videos Namasha suggests next to a video (page 1 about 12, later pages 20 each) |
| The public comments of a video: text, author, age, likes, replies |
| A channel: name, verified flag, description, creation date, links |
| A channel's videos, newest first, 60 per page |
| The videos on the home page: editors' picks or the special row |
| Namasha's video categories with the slug the category tool takes |
| 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-mcpDevelopment
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.comReleases: 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…
This server cannot be deployed
Maintenance
Related MCP Connectors
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
YouTube for AI agents: transcripts, comments, video stats, channel monitor, Shorts captions.
Transcripts, summaries, chapters and timestamped search for video links, for AI agents.
Search YouTube videos, read transcripts and get public video information in your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.2GPL 3.0
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to search videos, retrieve transcripts and metadata, analyze channels, and access trending and engagement analytics for YouTube content.18 npm-
- AlicenseAqualityBmaintenanceEnables 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.7144 PyPIPolyForm Noncommercial 1.0.0
- AlicenseAqualityBmaintenanceEnables 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.11144 PyPIPolyForm Noncommercial 1.0.0