movieplexx-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DB_PATH | No | SQLite file location | /data/movieplexx.db |
| MCP_HOST | No | HTTP bind address (http transport) | 0.0.0.0 |
| MCP_PATH | No | HTTP endpoint path (http transport) | /mcp |
| MCP_PORT | No | HTTP port (http transport) | 8000 |
| LOG_LEVEL | No | Logging level | INFO |
| TARGET_URL | No | Source endpoint | https://movieplexx.de/programm/api/filtered-films |
| USER_AGENT | No | Self-identifying User-Agent | MovieplexxProgrammMirror/0.1 (+kontakt@zahlenhelfer.de) |
| METRICS_PORT | No | Prometheus endpoint port in loop mode (<=0 disables) | 9000 |
| MCP_TRANSPORT | No | Transport for serve: stdio (local) or http (remote) | stdio |
| MCP_AUTH_TOKEN | No | Bearer token; required for http transport (fail-closed) | |
| POLL_INTERVAL_SECONDS | No | Loop interval for scrape --loop | 3600 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_showtimesB | List performances, optionally filtered by ISO date (YYYY-MM-DD) or film slug. Set only_upcoming to hide performances whose date lies in the past. |
| get_filmA | Return the full film record for one slug, or null if unknown. |
| search_filmsA | Search films by title, genre, director or distributor (case-insensitive substring). |
| film_historyA | Return the append-only scrape history for a film's performances (sold-out / status drift). |
| list_filmsB | List all known films. With only_current, restrict to films with an upcoming performance. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Tools are mostly distinct: film_history covers performance history, get_film and list_films cover films, list_showtimes covers performances, and search_films covers search. However, list_films with upcoming filter and search_films could be confused for similar film queries.
Four tools follow verb_noun pattern (get_film, list_films, list_showtimes, search_films), but film_history is a noun_noun exception, causing minor inconsistency.
With 5 tools, the set is well-scoped for a movie information server, fitting the ideal range of 3-15 tools for focused functionality.
The server covers key read operations: listing, searching, detail, showtimes, and history. Minor gaps include lacking a dedicated performance detail tool, but the set is largely complete for its domain.