# Filimo and Namava (pypi · iran-vod-mcp)

Read-only Filimo and Namava catalogs: search, title details, episodes, new, genres, where to watch.

- Trust score: 64/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- pypi · `iran-vod-mcp`: 64/100 (this document), [markdown](https://verifymcp.io/servers/sepehr071-iran-vod-mcp/iran-vod-mcp.md), [page](https://verifymcp.io/servers/sepehr071-iran-vod-mcp/iran-vod-mcp)

## Channel facts

- Registry: `pypi`
- Package: `iran-vod-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 50/100
  - Malware scan not yet available for this package.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 1 of 35 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to sepehr071/iran-vod-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 67/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2692 tokens (~207/item across 13 items; 13 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 13 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 14 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Filimo and Namava MCP server?

Filimo and Namava runs locally as a PyPI package, launched with uvx iran-vod-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add sepehr071-iran-vod-mcp -- uvx iran-vod-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "sepehr071-iran-vod-mcp": {
      "command": "uvx",
      "args": [
        "iran-vod-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "sepehr071-iran-vod-mcp": {
      "command": "uvx",
      "args": [
        "iran-vod-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add sepehr071-iran-vod-mcp -- uvx iran-vod-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sepehr071-iran-vod-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "iran-vod-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sepehr071-iran-vod-mcp --command uvx --arg iran-vod-mcp
```

### Hermes

```yaml
mcp_servers:
  sepehr071-iran-vod-mcp:
    command: "uvx"
    args: ["iran-vod-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "sepehr071-iran-vod-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "iran-vod-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add sepehr071-iran-vod-mcp -t stdio -c uvx -a iran-vod-mcp
```

### Other

```json
{
  "mcpServers": {
    "sepehr071-iran-vod-mcp": {
      "command": "uvx",
      "args": [
        "iran-vod-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 64, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-04 (score 79)

First indexed and scored.

## MCP tools (13)

### `vod_search` (~176 tokens)

Search Filimo and Namava

Search the Filimo and Namava catalogs by title and return matching movies and series with a ref for each.

Use first when the user names a title. Each hit has a `ref` to pass to vod_title (full details), vod_episodes
(series seasons and episodes). Use vod_where instead to learn which service has one specific title.
Filimo hits include year, rating, genres and a summary; Namava search only returns title, kind and year.

Input parameters:

- `kind` (string): Only movies, only series, or all.
- `limit` (integer): Max titles per site.
- `query` (string, required): Title words in Persian (or the Latin title for Filimo), e.g. شام ایرانی.
- `site` (string): Which catalog to search; 'both' (default) searches Filimo and Namava.

### `vod_where` (~142 tokens)

Where to watch a title

Tell which of Filimo and Namava carries a title, by searching both and matching the title text.

Use for "is X on Filimo or Namava". Returns the matching titles per site (exact title match first, then titles
that contain the words) and `available_on`. Only the catalogs are checked, not whether a title needs a
subscription; use vod_title for that. Pass vod_search results to vod_title for details.

Input parameters:

- `title` (string, required): Exact or near-exact title in Persian, e.g. شام ایرانی.
- `year`: Production year (Persian calendar like 1403, or Gregorian) to tell remakes apart.

### `vod_title` (~229 tokens)

Title details

Get full details of one movie or series on Filimo or Namava: synopsis, genres, year, rating, age rating, cast, director.

Use after vod_search, vod_browse or vod_new with the `ref` of a hit. For a series, follow with vod_episodes to
list seasons and episodes; vod_related gives similar titles and vod_person a cast member's filmography. Ratings
differ per site: Filimo gives stars out of 5 with a vote count and an IMDb score; Namava gives like and dislike
counts (and an IMDb score for newer titles). Filimo's cast for a movie is the names in its description text; for a
series it is the actors Filimo features (a few main ones). Namava `people` maps each name to a ref for vod_person.

Input parameters:

- `ref` (string, required): Title ref from vod_search, vod_new, vod_browse or vod_featured, e.g. 'filimo:0bd4p', 'filimo:150570' or 'namava:series:2377'.

### `vod_episodes` (~158 tokens)

Series seasons and episodes

List the seasons of a series and the episodes of one season (title, summary, length, publish date).

Use after vod_search or vod_title when the user wants episodes, how many seasons exist or the newest episode.
Takes a series ref; a movie ref returns an error. Default season is the latest. Streaming links are not provided.

Input parameters:

- `limit` (integer): Max episodes to return.
- `ref` (string, required): Title ref from vod_search, vod_new, vod_browse or vod_featured, e.g. 'filimo:0bd4p', 'filimo:150570' or 'namava:series:2377'.
- `season`: Season number (1 = first). Default: the latest season.

### `vod_new` (~123 tokens)

New releases

List the newest titles added to Filimo and Namava, most recent first.

Use for "what is new on Filimo/Namava". Filimo lists include year, rating and summary; Namava lists only title
and kind (call vod_title for more). Use vod_featured for what each site promotes on its front page instead.

Input parameters:

- `kind` (string): Only movies, only series, or all.
- `limit` (integer): How many titles to return.
- `site` (string): Which catalog; 'both' (default) returns two lists.

### `vod_featured` (~160 tokens)

Front-page picks

Show what Filimo and Namava promote right now: Filimo's front-page rows (new, popular, box office, genres) and Namava's top slider and top list.

Use for "what is popular / trending on Filimo or Namava". These are editorial picks, not view counts. Take a
\`ref` from here to vod_title for details. For Namava's most-viewed list use vod_collection(key="namava:popular").

Input parameters:

- `kind` (string): Filimo only: use the Movies page or the Series page rows (the Series page has the popular series row).
- `per_row` (integer): Titles per row.
- `site` (string): Which catalog; 'both' (default) returns both.

### `vod_genres` (~74 tokens)

List genres

List the genre names vod_browse accepts for Filimo and Namava, with the English aliases.

Use before vod_browse when unsure of a genre name. Persian names work for both sites; English aliases such as
comedy or drama work too. Filimo also takes sort and country filters (see vod_browse).

### `vod_browse` (~279 tokens)

Browse by genre

List movies and series of one genre on Filimo and Namava, with Filimo's sort and country filters.

Use for "best comedy series on Filimo", "Iranian dramas", "new documentaries". Filimo rows carry year, rating,
IMDb and summary; Namava rows only title, kind and id (use vod_title). Next: vod_title or vod_episodes. For themed
lists (IMDb top 250, Oscar, kids, coming soon) use vod_collections instead.

Input parameters:

- `country`: Filimo only: producer country filter such as iran, america, turkey, s_korea (list in vod_genres).
- `genre` (string, required): Genre name in Persian or English, e.g. کمدی, comedy, درام, documentary. See vod_genres.
- `kind` (string): Only movies, only series, or all. Namava ignores this and returns both kinds.
- `limit` (integer): How many titles to return.
- `page` (integer): Page number, 1 = first. Filimo pages reach about 200 titles per filter (5 site pages of 40).
- `site` (string): Which catalog; 'both' (default) returns two lists.
- `sort` (string): Filimo only: order of the list. Namava always lists newest first.

### `vod_person` (~189 tokens)

Actor or director profile

Look up an actor, director or writer on Filimo and Namava: short bio and the titles they appear in.

Use for "what has X acted in / directed on Filimo or Namava". Titles carry a `ref` for vod_title. Filimo gives
birth date and place when it has them; Namava gives a bio text. A name matches the first search hit (exact name
first); `other_matches` lists further people with similar names. Series appear once, not per episode.

Input parameters:

- `limit` (integer): Max titles per site.
- `name` (string, required): Person's name in Persian (Filimo also takes the Latin name), e.g. پارسا پیروزفر; or a 'namava:person:<id>' ref from vod_title.
- `site` (string): Which catalog; 'both' (default) looks on Filimo and Namava.

### `vod_related` (~150 tokens)

Similar titles

List titles similar to one movie or series on Filimo or Namava ("viewers also watch").

Use after vod_title when the user wants more like it. Filimo also returns its related rows (more by the same
actors or writer, same genre and decade) and the featured actors and writers; Namava returns one recommendation list.
Take a `ref` from the result to vod_title.

Input parameters:

- `limit` (integer): Max similar titles.
- `ref` (string, required): Title ref from vod_search, vod_new, vod_browse or vod_featured, e.g. 'filimo:0bd4p', 'filimo:150570' or 'namava:series:2377'.

### `vod_collections` (~120 tokens)

List collections

List the curated lists vod_collection can open on Filimo and Namava: IMDb top 250, Oscar, kids, coming soon and more.

Use when the user asks for a themed list (best-of, festival winners, kids, Korean or Turkish series, true stories).
Each entry has a `key` to pass to vod_collection. Namava category groups (any slug from vod_genres) also work as
\`namava:category:<slug>`.

Input parameters:

- `site` (string): Which catalog; 'both' (default) lists both.

### `vod_collection` (~259 tokens)

Open a collection

Show the titles of one curated list on Filimo or Namava, such as the IMDb top 250 or coming soon.

Use after vod_collections. Filimo lists accept sort and country filters and reach about 200 titles; Namava lists
are fixed (newest or editorial order, `upcoming` marks titles without a release date). The Filimo key 'kids' opens
the kids home page as several rows. Next: vod_title with a `ref`.

Input parameters:

- `country`: Filimo only: producer country filter such as iran, turkey (see vod_genres).
- `key` (string, required): A key from vod_collections, e.g. 'filimo:imdbtop250', 'filimo:animated_under_15/under_6', 'namava:popular', 'namava:coming_soon', 'namava:post:1437' or 'namava:category:persian'.
- `kind` (string): Only movies, only series, or all.
- `limit` (integer): How many titles to return.
- `page` (integer): Page number, 1 = first.
- `sort` (string): Filimo only: order of the list (not for the kids age keys).

### `vod_plans` (~113 tokens)

Subscription plans

Show Namava's public subscription plans and prices (Filimo's prices are not available in its JSON API).

Use for "how much is a Namava subscription". Prices are in toman before 10% VAT. `price` is the list price,
\`price_new_user` the discounted price shown to new users (what a guest sees); `auto_renew` is the monthly plan that
renews itself. Filimo shows its prices only in its payment page (https://www.filimo.com/payment).

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/sepehr071-iran-vod-mcp/iran-vod-mcp#diagnostics

## Score history

- 2026-11-05: 64
- 2026-11-04: 79

## Common questions

### What is the Filimo and Namava MCP server?

Filimo and Namava is an MCP server listed in the public MCP registry as io.github.sepehr071/iran-vod-mcp. Read-only Filimo and Namava catalogs: search, title details, episodes, new, genres, where to watch. This page covers its PyPI package (iran-vod-mcp).

### Is the Filimo and Namava MCP server safe to use?

Filimo and Namava scores 64 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Filimo and Namava MCP server expose?

Filimo and Namava exposes 13 tools: vod_search, vod_where, vod_title, vod_episodes, vod_new, and 8 more. Their descriptions and schemas cost roughly 2,172 tokens of context every time the server is loaded.

### Is the Filimo and Namava MCP server still maintained?

Filimo and Namava is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Filimo and Namava MCP server under?

Filimo and Namava declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/iran-vod-mcp/
- Socket report: https://socket.dev/pypi/package/iran-vod-mcp
- Repository: https://github.com/sepehr071/iran-vod-mcp
- Changelog RSS feed: https://verifymcp.io/servers/sepehr071-iran-vod-mcp/iran-vod-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/sepehr071-iran-vod-mcp/iran-vod-mcp.json
- HTML version of this page: https://verifymcp.io/servers/sepehr071-iran-vod-mcp/iran-vod-mcp