speedwarnsf/scenef-mcp

Built by movie lovers, for movie lovers and their assistants.
SceneF started in San Francisco — one of the last great moviegoing cities:
single-screen neighborhood houses from the 1920s, repertory calendars that
change nightly, 35mm and 70mm prints, midnight movies, and yes, the
multiplexes too. It now runs **56 regional boards across California, Florida and
Hawaii** — Los Angeles to Sacramento, San Diego to Maui, Miami to Pensacola.
Each board brings venue schedules and a third-party showtimes data service
together, with source confidence and freshness so callers can see what the
listings are based on.
Remote MCP server, streamable HTTP, no API key, read-only — and a local
stdio server in this repo, running the same ten tools.
**Every tool except scenef_resolve_board takes a region** — "sf", "la-central", "oahu",
"sacramento", … — and omitting it means the default board (sf), never a
guess from where you are. Use scenef_resolve_board for a named place and
scenef_now with no region for the current list of boards.
Times are each theatre's own wall clock: Hawaii runs two or three hours off Pacific
and keeps no DST, and each board reports its timezone with its data.
Connect
**Claude Code**
**Claude Desktop / any MCP client** (.mcp.json / client config)
Also listed in the official MCP registry as com.scenef/showtimes.
Or run it locally
This repo is also a **local MCP server** — Node, stdio, no proxy. It speaks
the protocol itself and reads the same board over SceneF's public REST API.
The same ten public tools and matching rules are available on either
transport. REST caching can make the two responses differ briefly.
**Claude Desktop / any stdio client**
**From a clone, or Docker**
No API key, no account, no configuration. It sends User-Agent:
scenef-mcp-local/1.1, issues nothing but GET, and has no write path
anywhere in it.
npm test first runs offline regressions against the saved hosted schema
contract and fixture feeds. test/contract.js calls all ten tools against
the live board and validates every payload against the output schema the
server advertises, and test/parity.js diffs this server's tool definitions
against the hosted endpoint's. For a local preview, set both
SCENEF_BASE_URL=http://localhost:3017 and
SCENEF_MCP_URL=http://localhost:3017/mcp. No external schema refresh is
claimed by a successful offline run. If that preview has a limited dataset,
set SCENEF_PARITY_REGION=oahu (or another populated nondefault board) for
the regional probes; the default is la-central.
Tools
| Tool | What it answers |
| --- | --- |
| scenef_whats_playing | Ranked films for tonight / tomorrow / the weekend / a date — when the window covers tonight, opens with **Notable tonight**: scarcity facts with receipts (measured seat counts, final nights, lone 35/70mm prints, posted discounts, live events) |
| scenef_search_showtimes | Showtimes for one film or theater, with date and hard time filters |
| scenef_theater_info | One theater: address, neighborhood, standing discounts, upcoming board |
| scenef_film_details | Year, runtime, rating, cast, trailer, the nearest upcoming showtimes |
| scenef_plan_movie_night | Constraints in (time window, genres, formats, theaters), a plan out |
| scenef_discounts | The cheap nights, board-wide |
| scenef_coming_soon | What's opening next |
| scenef_resolve_board | A city, ZIP, neighborhood or alias to the board that covers it — or a refusal that says which kind of no |