INDIVIDUAL MCP TOOL

search_catalog

Ranked search across films, people, posts, public lists, and public profiles.

films.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://films.io/api/mcp

No auth detected

Connect to this endpoint to inspect the live schema for search_catalog and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.films-io]
url = "https://films.io/api/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "films-io": {
      "type": "http",
      "url": "https://films.io/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: films-io
Remote MCP URL: https://films.io/api/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "films-io": {
      "url": "https://films.io/api/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "films-io": {
      "type": "http",
      "url": "https://films.io/api/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "films-io",
  "transport": "streamable-http",
  "url": "https://films.io/api/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

search_films — Search the curated films.io catalog by title, director, actor, or genre.
get_film — Get one catalog film as JSON.
similar_films — Similar catalog films from enrichment.similar_films then tones and genre.
compare_films — Compare meters for two catalog slugs.
get_person — Get one catalog person by /p/{slug}: filmography in this catalog, collaborators, editorial.
program_night — Pack a night from catalog meters.
where_to_watch — Return enrichment.where_to_watch for a catalog slug.