# Yorck Cinema (Berlin) — Agent Skill

> Find showtimes, browse seat maps, and plan a movie night across all 14 Yorck cinemas in Berlin — via a public, no-auth MCP endpoint.

## What this skill is

A drop-in agent skill that teaches your AI assistant how to query the **public Yorck MCP** at:

```
https://yorck-mcp.isiklimahir.workers.dev
```

No API key, no auth, no setup. Read-only. Perfect for movie-night planners, Berlin city agents, calendar assistants, or any agent that wants up-to-date cinema data.

## Endpoints

### MCP (Streamable HTTP / SSE)

- `https://yorck-mcp.isiklimahir.workers.dev/public/mcp` — Streamable HTTP
- `https://yorck-mcp.isiklimahir.workers.dev/public/sse` — SSE

### REST (great for one-shot calls)

| Endpoint | Returns |
|---|---|
| `GET /v1/films` | All currently playing films + 7-day showtimes (~570 sessions) |
| `GET /v1/films/search?q=:query` | Film search by title |
| `GET /v1/coming-soon` | Upcoming releases |
| `GET /v1/cinemas` | 14 Yorck cinemas with vista IDs, districts, addresses, coordinates |
| `GET /v1/seat-plan/:sessionId` | Seat plan for a specific session |
| `GET /v1/seat-map/:sessionId` | SVG seat map for visual rendering |

## What the agent can do

When this skill is loaded, the agent can answer questions like:

- "What's playing tonight near Kreuzberg?"
- "Find me a Sandra Hüller film this week"
- "Compare seats available for Devil Wears Prada 2 across Yorck cinemas tomorrow"
- "What's coming soon in arthouse this month?"
- "Plan a movie night for Friday 8pm walking distance from Prenzlauer Berg"

## How to use it (in your agent)

### Pattern 1: Direct REST call (simplest)

```bash
# Search for a film
curl -s "https://yorck-mcp.isiklimahir.workers.dev/v1/films/search?q=devil"

# Get all cinemas
curl -s "https://yorck-mcp.isiklimahir.workers.dev/v1/cinemas"
```

### Pattern 2: Connect as MCP server (Claude Desktop / Cursor / Pi)

```json
{
  "mcpServers": {
    "yorck": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://yorck-mcp.isiklimahir.workers.dev/public/mcp"]
    }
  }
}
```

### Pattern 3: Hermes / generic agent

This skill ships a helper script `scripts/yorck.sh` that wraps the public endpoints. Your agent can call it directly with bash:

```bash
~/.pi/agent/skills/yorck/scripts/yorck.sh films
~/.pi/agent/skills/yorck/scripts/yorck.sh search "devil wears prada"
~/.pi/agent/skills/yorck/scripts/yorck.sh cinemas
```

## Tools exposed (when used as MCP)

| Tool | Description |
|---|---|
| `yorck_whats_on` | Current films with showtimes — filter by cinema, time window, format (OmU/OmeU/OV) |
| `yorck_film_search` | Search films by title, director, or tagline |
| `yorck_cinemas` | List all 14 Yorck cinemas with district and coordinates |
| `yorck_coming_soon` | Upcoming releases |
| `yorck_seat_map` | SVG seat map for a specific session (renders availability) |
| `yorck_seat_plan` | Structured seat-plan data for a session |

## The 14 Yorck cinemas

| Cinema | District |
|---|---|
| Yorck | Kreuzberg |
| Babylon Kreuzberg | Kreuzberg |
| delphi LUX | Charlottenburg |
| Delphi Filmpalast | Charlottenburg |
| Cinema Paris | Charlottenburg |
| Kant Kino | Charlottenburg |
| Capitol Dahlem | Dahlem |
| Kino International | Mitte |
| Filmtheater am Friedrichshain | Prenzlauer Berg |
| Blauer Stern | Pankow |
| Rollberg | Neukölln |
| Passage | Neukölln |
| Neues Off | Neukölln |
| Odeon | Schöneberg |

## Format glossary

- `OV` — Original version (no subtitles)
- `OmU` — Original with German subtitles
- `OmeU` — Original with English subtitles

## Notes

- Public endpoint: anyone can call it, no key needed.
- Booking is private (uses Mahir's Yorck Unlimited credentials) and **not** exposed here.
- Data lives on Cloudflare Workers, refreshed continuously from the Yorck Vista backend.
- Not affiliated with Yorck-Kino GmbH. Built by [@mahirisikli](https://github.com/Mahir-Isikli) for AI agents.