yorck-mcp 0.1.0 → 0.1.2

package/README.md

@@ -3,8 +3,9 @@
 CLI and MCP tools for Yorck Berlin cinema.
 
 - Public search, film lookup, cinemas, seat maps, and ICS calendar files need no account.
-- Booking is local and opt-in. It needs your own Yorck account email, password, and Yorck Unlimited card number.
-- Real booking is never the default. Dry run validates Unlimited pricing and releases the seat hold.
+- Manual planning is usable without Yorck Unlimited. It returns showtimes, seat maps, calendar files, and a checkout link.
+- Automated booking is local and opt-in. Today it needs your own Yorck account email, password, and Yorck Unlimited card number.
+- Real automated booking is never the default. Dry run validates Unlimited pricing and releases the seat hold.
 
 ## CLI
 
@@ -15,6 +16,14 @@ npx yorck-mcp seat-map 1007-30456 --out seat-map.svg
 npx yorck-mcp calendar 1007-30456 the-devil-wears-prada-2 --out movie.ics
 ```
 
+Plan a manual booking, no account needed:
+
+```bash
+npx yorck-mcp plan --q "devil wears prada" --when tonight --after 18:00
+```
+
+This returns a checkout seat-selection link, for example `https://www.yorck.de/en/checkout/seats?sessionid=...`, plus the matching film, cinema, time, and a seat-plan summary. The manual flow lets the user choose seats on Yorck's page.
+
 ## Booking
 
 Dry run:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yorck-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "type": "module",
   "scripts": {

package/src/cli.ts

@@ -161,6 +161,10 @@ function shortTime(iso: string): string {
   return m ? `${m[1]} ${m[2]}` : iso;
 }
 
+function sessionBookingUrl(env: Env, showtime: Showtime): string {
+  return `${env.YORCK_BASE.replace(/\/$/, "")}/en/checkout/seats?sessionid=${encodeURIComponent(showtime.sessionId)}`;
+}
+
 function printShowtimes(showtimes: Showtime[], limit = 20) {
   if (!showtimes.length) {
     console.log("No matching showtimes.");
@@ -367,7 +371,7 @@ async function commandBook(env: Env, args: ParsedArgs) {
   printJson(await bookSpecific(env, args, { sessionId, cinemaSlug, rowLabel, seatId }));
 }
 
-async function commandBookBest(env: Env, args: ParsedArgs) {
+async function pickBestShowtime(env: Env, args: ParsedArgs) {
   const search = await searchShowtimes(env, filters(args));
   const candidates = rankShowtimes(search).slice(0, intOpt(args, "candidates") ?? 8);
   for (const showtime of candidates) {
@@ -375,20 +379,46 @@ async function commandBookBest(env: Env, args: ParsedArgs) {
       const { rows } = await seatPlanForSession(env, showtime.sessionId);
       const seat = pickSeat(rows);
       if (!seat) continue;
-      const booking = await bookSpecific(env, args, {
-        sessionId: showtime.sessionId,
-        cinemaSlug: showtime.cinemaSlug,
-        rowLabel: seat.rowLabel,
-        seatId: seat.seatId,
-        showtime,
-      });
-      printJson({ selected: { ...showtime, seat: { row: seat.rowLabel, seat: seat.seatId } }, booking });
-      return;
+      return { showtime, seat, seatPlanSummary: rows };
     } catch (error) {
       if (bool(args, "verbose")) console.error(`Skipping ${showtime.sessionId}: ${String(error)}`);
     }
   }
-  throw new Error("No bookable showtime with available seats found");
+  return null;
+}
+
+async function commandPlan(env: Env, args: ParsedArgs) {
+  const picked = await pickBestShowtime(env, args);
+  if (!picked) throw new Error("No matching showtime with available seats found");
+  const { showtime, seat, seatPlanSummary } = picked;
+  printJson({
+    ok: true,
+    selected: showtime,
+    manualBookingUrl: sessionBookingUrl(env, showtime),
+    filmPageUrl: showtime.url,
+    apiSeatForAutomation: { row: seat.rowLabel, seatId: seat.seatId },
+    note: "No Yorck account or Unlimited card needed. This does not reserve the seat; use the Yorck checkout page to choose and book manually. apiSeatForAutomation is for the booking API, not necessarily the visible seat label on Yorck's website.",
+    next: {
+      seatMap: `npx yorck-mcp seat-map ${showtime.sessionId} --out seat-map.svg`,
+      calendar: `npx yorck-mcp calendar ${showtime.sessionId} ${showtime.slug} --out movie.ics`,
+      unlimitedDryRun: `YORCK_EMAIL=... YORCK_PASSWORD=... YORCK_UNLIMITED_CARD=... npx yorck-mcp book-best --q ${JSON.stringify(showtime.film)} --when tonight`,
+    },
+    seatPlanSummary,
+  });
+}
+
+async function commandBookBest(env: Env, args: ParsedArgs) {
+  const picked = await pickBestShowtime(env, args);
+  if (!picked) throw new Error("No bookable showtime with available seats found");
+  const { showtime, seat, seatPlanSummary } = picked;
+  const booking = await bookSpecific(env, args, {
+    sessionId: showtime.sessionId,
+    cinemaSlug: showtime.cinemaSlug,
+    rowLabel: seat.rowLabel,
+    seatId: seat.seatId,
+    showtime,
+  });
+  printJson({ selected: { ...showtime, seat: { row: seat.rowLabel, seat: seat.seatId } }, booking, seatPlanSummary });
 }
 
 async function commandMe(env: Env, args: ParsedArgs) {
@@ -447,6 +477,7 @@ Usage:
   yorck coming-soon
   yorck seat-map <session-id> [--out seat-map.svg]
   yorck calendar <session-id> <film-slug> [--out event.ics]
+  yorck plan --q <film> --when tonight --after 18:00
   yorck me [--email you@example.com --password ...]
   yorck book <session-id> --cinema <slug> --row <row> --seat <seat> [--commit --yes]
   yorck book-best --q <film> --when tonight --after 18:00 [--commit --yes]
@@ -484,6 +515,9 @@ async function main() {
     case "calendar":
     case "ics":
       return commandCalendar(env, args);
+    case "plan":
+    case "pick":
+      return commandPlan(env, args);
     case "me":
       return commandMe(env, args);
     case "book":

package/src/index.ts

@@ -35,15 +35,90 @@ function requireAuth(c: { req: { raw: Request }; env: Env; text: (body: string,
 }
 
 app.get("/", (c) =>
-  c.text(
-    [
-      "yorck-mcp Worker.",
-      "Public read-only MCP: /public/mcp (Streamable HTTP), /public/sse (SSE).",
-      "Private authenticated MCP with booking: /mcp, /sse.",
-      "Public REST: /v1/films, /v1/films/search, /v1/coming-soon, /v1/cinemas, /v1/seat-plan/:sessionId, /v1/seat-map/:sessionId.",
-      "Private REST: /v1/book/*, /v1/me, /v1/browser-*.",
-    ].join("\n")
-  )
+  c.html(`<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>yorck-mcp</title>
+  <style>
+    :root { color-scheme: light dark; --bg: #f7f6f2; --fg: #191919; --muted: #66615b; --card: #fff; --line: #e4e0d8; --accent: #d62828; }
+    @media (prefers-color-scheme: dark) { :root { --bg: #121212; --fg: #f6f2ea; --muted: #bbb2a8; --card: #1c1c1c; --line: #333; } }
+    body { margin: 0; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: radial-gradient(circle at 20% 0%, rgba(214,40,40,.12), transparent 34rem), var(--bg); color: var(--fg); }
+    main { max-width: 980px; margin: 0 auto; padding: 64px 22px; }
+    h1 { font-size: clamp(44px, 7vw, 86px); letter-spacing: -.07em; line-height: .92; margin: 0 0 18px; }
+    h2 { font-size: 24px; letter-spacing: -.03em; margin-top: 0; }
+    p { color: var(--muted); font-size: 18px; line-height: 1.6; }
+    .pill { display: inline-flex; align-items: center; gap: 8px; border: 1px solid var(--line); background: color-mix(in srgb, var(--card) 84%, transparent); border-radius: 999px; padding: 8px 12px; color: var(--muted); font-weight: 700; font-size: 14px; }
+    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px; margin: 32px 0; }
+    .card { background: color-mix(in srgb, var(--card) 92%, transparent); border: 1px solid var(--line); border-radius: 28px; padding: 24px; box-shadow: 0 24px 80px rgba(0,0,0,.08); }
+    code, pre { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
+    pre { overflow-x: auto; background: #111; color: #f6f2ea; border-radius: 20px; padding: 18px; font-size: 14px; line-height: 1.55; }
+    a { color: var(--accent); font-weight: 800; }
+    ul { color: var(--muted); line-height: 1.8; padding-left: 20px; }
+  </style>
+</head>
+<body>
+  <main>
+    <span class="pill">Yorck Berlin cinema · CLI + MCP</span>
+    <h1>search showtimes, render seats, optionally book with your own Unlimited account.</h1>
+    <p><strong>yorck-mcp</strong> is a public read-only MCP server, a terminal CLI, and a local bookable stdio MCP for agents. Public search, seat maps, calendar files, and direct checkout links need no account. Automated booking stays local and currently requires your Yorck email, password, and Unlimited card number.</p>
+
+    <div class="grid">
+      <section class="card">
+        <h2>Public MCP</h2>
+        <p>Use the hosted read-only endpoint in any MCP client.</p>
+        <pre>{
+  "mcpServers": {
+    "yorck": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://yorck-mcp.isiklimahir.workers.dev/public/mcp"]
+    }
+  }
+}</pre>
+      </section>
+      <section class="card">
+        <h2>CLI</h2>
+        <p>Use it directly from a terminal.</p>
+        <pre>npx -y yorck-mcp whats-on --when tonight --after 18:00
+npx -y yorck-mcp search "devil wears prada"
+npx -y yorck-mcp seat-map 1007-30456 --out seat-map.svg
+npx -y yorck-mcp plan --q "devil wears prada" --when tonight --after 18:00</pre>
+      </section>
+      <section class="card">
+        <h2>Bookable local MCP</h2>
+        <p>Run a local stdio MCP with your credentials. Dry-run is the safe default, real automated booking requires explicit confirmation. Without Unlimited, use the returned checkout link and finish paid checkout on Yorck's site.</p>
+        <pre>{
+  "mcpServers": {
+    "yorck": {
+      "command": "npx",
+      "args": ["-y", "yorck-mcp", "mcp-stdio"],
+      "env": {
+        "YORCK_EMAIL": "you@example.com",
+        "YORCK_PASSWORD": "...",
+        "YORCK_UNLIMITED_CARD": "..."
+      }
+    }
+  }
+}</pre>
+      </section>
+    </div>
+
+    <section class="card">
+      <h2>Tools</h2>
+      <ul>
+        <li><code>whats_on</code>, search showtimes by date, time, cinema, format, genre, and title</li>
+        <li><code>find_film</code>, <code>showtimes</code>, <code>coming_soon</code>, <code>cinemas</code></li>
+        <li><code>seat_map</code>, render a session seat plan as SVG and return available row and seat IDs</li>
+        <li><code>pick_showtime</code>, pick a public session and return a checkout seat-selection link</li>
+        <li><code>add_to_calendar</code>, generate an ICS file or downloadable calendar URL</li>
+        <li><code>book_session</code> and <code>cancel_booking</code>, private/local only</li>
+      </ul>
+      <p>Docs and post: <a href="https://mahir.is/posts/yorck-mcp-public-cinema-agent">mahir.is/posts/yorck-mcp-public-cinema-agent</a></p>
+    </section>
+  </main>
+</body>
+</html>`)
 );
 
 // REST endpoints (also handy for quick curl tests)

package/src/tool-registration.ts

@@ -48,6 +48,60 @@ function publicBaseUrl(env: Env): string {
   return (env.PUBLIC_BASE_URL || "https://yorck-mcp.isiklimahir.workers.dev").replace(/\/$/, "");
 }
 
+function sessionBookingUrl(env: Env, showtime: Showtime): string {
+  return `${env.YORCK_BASE.replace(/\/$/, "")}/en/checkout/seats?sessionid=${encodeURIComponent(showtime.sessionId)}`;
+}
+
+function rankShowtimes(showtimes: Showtime[]) {
+  const priority: Record<string, number> = { OmeU: 4, OV: 3, OmU: 2, DF: 1 };
+  return [...showtimes].sort((a, b) => {
+    const fp = (priority[b.format] ?? 0) - (priority[a.format] ?? 0);
+    if (fp !== 0) return fp;
+    return a.start.localeCompare(b.start);
+  });
+}
+
+function seatRowsFromPlan(plan: Awaited<ReturnType<typeof getSeatPlan>>) {
+  return (plan.SeatLayoutData.Areas[0]?.Rows ?? []).map((row) => ({
+    physicalName: String(row.PhysicalName ?? row.RowIndexZeroBased),
+    rowIndex: row.RowIndexZeroBased,
+    availableIds: (row.Seats ?? []).filter((seat) => seat.Status === 0).map((seat) => seat.Id),
+  }));
+}
+
+function pickSeat(rows: Array<{ physicalName: string; rowIndex: number; availableIds: Array<string | number> }>) {
+  const availableRows = rows.filter((row) => row.availableIds?.length);
+  if (!availableRows.length) return null;
+  const minIndex = Math.min(...availableRows.map((r) => Number(r.rowIndex) || 0));
+  const maxIndex = Math.max(...availableRows.map((r) => Number(r.rowIndex) || 0));
+  const idealRow = minIndex + (maxIndex - minIndex) * 0.45;
+  const row = [...availableRows].sort((a, b) => {
+    const aDist = Math.abs((Number(a.rowIndex) || 0) - idealRow);
+    const bDist = Math.abs((Number(b.rowIndex) || 0) - idealRow);
+    if (aDist !== bDist) return aDist - bDist;
+    return (b.availableIds.length || 0) - (a.availableIds.length || 0);
+  })[0]!;
+  const seats = [...row.availableIds].sort((a, b) => Number(a) - Number(b));
+  return { rowLabel: String(row.physicalName), seatId: String(seats[Math.floor((seats.length - 1) / 2)]) };
+}
+
+async function pickBestShowtime(env: Env, filters: Parameters<typeof searchShowtimes>[1], candidatesLimit = 8) {
+  const showtimes = rankShowtimes(await searchShowtimes(env, filters)).slice(0, candidatesLimit);
+  for (const showtime of showtimes) {
+    const [cinemaVistaId, sessionNum] = showtime.sessionId.split("-");
+    if (!cinemaVistaId || !sessionNum) continue;
+    try {
+      const plan = await getSeatPlan(env, cinemaVistaId, sessionNum);
+      const rows = seatRowsFromPlan(plan);
+      const seat = pickSeat(rows);
+      if (seat) return { showtime, seat, rows };
+    } catch {
+      // Try the next candidate.
+    }
+  }
+  return null;
+}
+
 export function registerPublicTools(server: McpServer, env: Env) {
   server.tool(
     "whats_on",
@@ -141,6 +195,33 @@ export function registerPublicTools(server: McpServer, env: Env) {
     }
   );
 
+  server.tool(
+    "pick_showtime",
+    "Read-only helper that searches showtimes, chooses a reasonable available seat, and returns a manual booking URL. No account, reservation, or payment needed.",
+    {
+      ...FilmFiltersSchema,
+      candidates: z.number().int().min(1).max(20).optional().describe("How many top search results to inspect for available seats. Default 8."),
+    },
+    async ({ candidates, ...args }) => {
+      const picked = await pickBestShowtime(env, args, candidates ?? 8);
+      if (!picked) throw new Error("No matching showtime with available seats found");
+      const { showtime, seat, rows } = picked;
+      return {
+        content: [{
+          type: "text" as const,
+          text: JSON.stringify({
+            selected: showtime,
+            manualBookingUrl: sessionBookingUrl(env, showtime),
+            filmPageUrl: showtime.url,
+            apiSeatForAutomation: { row: seat.rowLabel, seatId: seat.seatId },
+            note: "This is a read-only plan and does not reserve the seat. Use Yorck checkout manually, or use book_session with local credentials for the Unlimited booking flow. apiSeatForAutomation is for the booking API, not necessarily the visible seat label on Yorck's website.",
+            rows,
+          }, null, 2),
+        }],
+      };
+    }
+  );
+
   server.tool(
     "add_to_calendar",
     "Generate an .ics calendar event for a public Yorck showtime.",