iran-vod-mcp
An unofficial, read-only MCP server providing access to the public catalogs of Iranian streaming services Filimo and Namava. It allows AI agents to search for titles, retrieve details like synopsis and ratings, list episodes, find similar titles, and browse genres without requiring an API key or account.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Search for movies and series on Filimo and Namava
- Retrieve title details including synopsis, rating, and cast
- List seasons and episodes for a specific series
- Find which service carries a specific title
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
iran-vod-mcp 0.2.0
{
"version": "0.2.0",
"transport": "stdio",
"identifier": "iran-vod-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "IRAN_VOD_MCP_PROXY",
"description": "Optional HTTP proxy URL for the Filimo and Namava requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"iran-vod-mcp": {
"command": "uvx",
"args": [
"iran-vod-mcp==0.2.0"
],
"env": {
"IRAN_VOD_MCP_PROXY": "<YOUR_IRAN_VOD_MCP_PROXY>"
}
}
}
}Cline
{
"mcpServers": {
"iran-vod-mcp": {
"command": "uvx",
"args": [
"iran-vod-mcp==0.2.0"
],
"env": {
"IRAN_VOD_MCP_PROXY": "<YOUR_IRAN_VOD_MCP_PROXY>"
}
}
}
}VS Code
{
"servers": {
"iran-vod-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"iran-vod-mcp==0.2.0"
],
"env": {
"IRAN_VOD_MCP_PROXY": "<YOUR_IRAN_VOD_MCP_PROXY>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"iran-vod-mcp": {
"command": "uvx",
"args": [
"iran-vod-mcp==0.2.0"
],
"env": {
"IRAN_VOD_MCP_PROXY": "<YOUR_IRAN_VOD_MCP_PROXY>"
}
}
}
}Let your agent find its tools
Find servers like iran-vod-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.