# Cinema Timișoara — Full agent guide

> Independent arthouse cinemas in Timișoara, Romania: Victoria, Timiș, Johnny, Studio, and more.

## What this site offers
- Public movie and event program (screenings, festivals, special series)
- Movie pages with synopses, cast, ratings, and upcoming showtimes
- Cinema venue pages with addresses and contact info
- News articles about the local film scene

## Read-only agent API
Base URL: https://cinema-timisoara.ro/mcp/api/v1/

| Endpoint | Purpose |
|----------|---------|
| GET /mcp/api/v1/program/ | Upcoming screenings (filter by cinema, genre, rating, subtitles, specials) |
| GET /mcp/api/v1/program/filters/ | Available filter values |
| GET /mcp/api/v1/movies/ | Movie catalog (`?tag=now_playing|coming_soon|archive`, `?search=`) |
| GET /mcp/api/v1/movies/<id>/ | Movie detail + upcoming performances |
| GET /mcp/api/v1/performances/<id>/ | Single performance details |
| GET /mcp/api/v1/search/?q= | Search movies and performances |
| GET /mcp/api/v1/cinemas/ | Cinema venues |
| GET /mcp/api/v1/collections/ | Festivals and special series |
| GET /mcp/api/v1/specials/ | Program specials metadata |

## Content negotiation
Send `Accept: text/markdown` on public pages or `/mcp/api/v1/*` for markdown (`Vary: Accept`).

## MCP (streamable HTTP)
- Endpoint: https://cinema-timisoara.ro/mcp
- Server card: https://cinema-timisoara.ro/.well-known/mcp.json
- OpenAPI: https://cinema-timisoara.ro/openapi.json

## Ticket purchases
Direct users to page URLs from the API. Do **not** use `/api/cart/`, `/api/checkout/`, or `/api/user/*`.

## Language
Romanian (`ro`) primary. Return titles and showtimes as stored; do not invent schedules.