SceneF — San Francisco Movie Showtimes
SceneF is a read-only MCP server for movie showtimes across California, Florida, and Hawaii, letting you discover films, search showtimes, get theater/film details, plan movie nights, find discounts, track coming-soon titles, see what's playing right now, and inspect the service's accuracy record.
scenef_whats_playing — Ranked films for tonight/tomorrow/weekend/a date, with genre/format filters, notable scarcity picks (last nights, lone 35/70mm prints, discounts, live events), and optional detailed showtime metadata.
scenef_search_showtimes — Find showtimes by film title/slug or by theater(s), with date and hard time-window filters; ambiguous titles return candidates.
scenef_theater_info — Get a theater's address, neighborhood, website, discounts, amenities, next 5 showtimes with ticket links, and calendar feed URL.
scenef_film_details — Full film card: year, runtime, genres, directors, cast, overview, rating, trailer/poster URLs, all upcoming showtimes, and last-night flags.
scenef_plan_movie_night — Generate 2–4 complete plans (film + showtime + theater + why) from a taste profile, with hard time bounds, home-venue nudges, discount-only options, and a wildcard pick.
scenef_discounts — Board-wide structured discount grid by venue, with day-bound days and today's applicable discounts flagged.
scenef_coming_soon — Films opening within a configurable horizon (1–90 days), sorted by first night, with opening venues.
scenef_now — Right-now snapshot: tonight's screening count, next 5 curtains city-wide, and dataset freshness per source.
scenef_resolve_board — Map a city, ZIP, neighborhood, or alias to the regional board that covers it, or get a clear refusal.
scenef_accuracy — Public verification record: site-wide and per-venue confidence mix, check counts (confirmed/missing/unreachable), pass rates, and methodology definitions.
Regional boards — Most tools accept a
region(e.g.sf,la-central,oahu,sacramento) to query one of 56 boards; omitting it defaults tosf.Confidence & provenance — Every screening carries confidence, source tier, sources, and verified_at; data_as_of and freshness indicate recency.
Transport options — Remote streamable HTTP MCP server at https://scenef.com/mcp, or run locally via npx/Docker as a stdio server; no API key required.
SceneF — Movie Showtimes for California, Florida & Hawaii (MCP server)
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.
https://scenef.com/mcpConnect
Claude Code
claude mcp add --transport http scenef https://scenef.com/mcpClaude Desktop / any MCP client (.mcp.json / client config)
{
"mcpServers": {
"scenef": {
"type": "http",
"url": "https://scenef.com/mcp"
}
}
}Also listed in the official MCP registry as com.scenef/showtimes.
Related MCP server: movieplexx-mcp
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.
npx -y github:speedwarnsf/scenef-mcpClaude Desktop / any stdio client
{
"mcpServers": {
"scenef": {
"command": "npx",
"args": ["-y", "github:speedwarnsf/scenef-mcp"]
}
}
}From a clone, or Docker
npm install && npm startdocker build -t scenef-mcp . && docker run --rm -i scenef-mcpNo 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 |
| 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) |
| Showtimes for one film or theater, with date and hard time filters |
| One theater: address, neighborhood, standing discounts, upcoming board |
| Year, runtime, rating, cast, trailer, the nearest upcoming showtimes |
| Constraints in (time window, genres, formats, theaters), a plan out |
| The cheap nights, board-wide |
| What's opening next |
| A city, ZIP, neighborhood or alias to the board that covers it — or a refusal that says which kind of no |
| Right-now snapshot: what's catchable at this hour |
| Our own verification record — checks run, failed, and unreachable |
Board-reading tools answer for one regional board at a time — pass region
to pick it. Preserve every returned ticket, calendar and film URL exactly,
including regional paths and ?region= hints. Invalid hard date/time filters
return a refusal and warnings, never an unfiltered success. No ads or paid
ranking. The repertory houses get the same billing as the chains — a lone
35mm print at a neighborhood house is exactly the kind of thing this server
exists to surface, whether that house is in the Richmond or in Hilo.
scenef_whats_playing in concise mode returns the total showtime_count
and just the next screening in showtimes; detailed mode adds showtime rows,
about 200 across the answer. scenef_film_details and
scenef_search_showtimes return the 40 nearest showtimes in concise mode and
up to 200 in detailed. showtime_count is always the total and
showtimes_complete says whether the array is all of it; narrow by date or
theater for the rest.
Why trust it
Showtimes come from venue schedules and a third-party showtimes data service. Many showtimes, including most chain theaters and some independents, come from that service rather than from the theater itself; they are labelled
source_tier: licensed-feedand carry the weakest claim on the site. Every returned screening carriesconfidence,source_tier,sources, andverified_atin both concise and detailed modes.data_as_ofis the dataset publication time.verified_atandfreshnessdescribe a screening's source evidence; a fresh dataset can retain older rows. Freshness measures recency, not correctness. Confirm stale or retained listings with the theater before relying on them.The verification record is public — including the checks that failed: scenef.com/api/accuracy.
The local scenef_now.sources summary counts theater health the way the
hosted server does, one theater at a time, and names each theater whose
listings may be out of date in the hosted words. It reads that health from
each listing's freshness.source_status, so a theater with no listings on
the board is not visible locally and is not counted; the hosted count can be
higher by those theaters, and the payload's basis and the prose's closing
Data: line say so. Apart from that line, the edge-cache note below and
input-validation errors (the MCP SDK words those differently; the limits are
the same), every answer's prose is the hosted server's, line for line. Per-screening freshness
comes from the canonical REST feed on both transports; the local server keeps
the feed's allowance, retained and source_status, and ages age_hours and
status from verified_at at call time, as the hosted server does.
The REST doors are served through an edge cache that, once a copy expires,
answers the next request from the expired copy while it refreshes. The hosted
server reads the current dataset and never sees such a copy. The local server
asks again (three retries over about three seconds) when the edge reports a
stale copy; if the edge is still serving it after that, the answer is built on
it and says so in one line after the footer, and data_as_of is that copy's.
Prefer plain HTTP?
The same data is served REST-style — see
scenef.com/agents for the full contract:
/api/listings ·
/ask ·
OpenAPI ·
llms.txt
Contact
Available Tools
9 toolsscenef_accuracyThe accuracy recordARead-only
Accuracy is computed, not claimed: every showtime carries a confidence level, a source tier, and a last-verified time, and the running record of our own verification checks — failures included — is public at https://scenef.com/api/accuracy. This tool returns that record: the site-wide confidence mix, the counts of verification checks confirmed / missing / unreachable over the record's window (window_days in the payload — 30 days at present) with the pass rate and the exact denominator it was computed from, the same per venue with source tier and last-verified time, and the definitions of every level. Checks that could not run — a bot wall, a client-rendered page — are graded unreachable and excluded from the pass rate rather than counted as passes. Quote these numbers directly; they are recomputed on every call.
Inputs: response_format. Returns: docs, site, method, venues, +2 more
scenef_coming_soonComing soon (on-sale radar)ARead-only
Films whose first SF screening is more than 48 hours out, sorted by first night — the on-sale radar for runs worth booking early. Configurable horizon. In "detailed" mode every showtime also carries its confidence level, source tier, reporting sources, and verified_at timestamp.
Inputs: horizon_days, response_format. Returns: films, data_as_of, film_count, attribution, +2 more
scenef_discountsDiscount gridARead-only
Every structured discount across all SF theaters — venue, label, detail, and day-bound days — with the ones that apply today flagged.
Inputs: response_format. Returns: venues, today_dow, data_as_of, today_name, +3 more
scenef_film_detailsFilm detailsARead-only
The full card for one film: title, year, runtime, genres, directors, cast, overview, rating, trailer and poster urls when present, every upcoming showtime with venue/time/ticket link, and a last-night flag when the run is ending. In "detailed" mode every showtime also carries its confidence level, source tier, reporting sources, and verified_at timestamp.
Inputs: film (required), response_format. Returns: film, query, matched, showtimes, +7 more
scenef_nowRight nowARead-only
The cheap is-anything-on call: how many screenings tonight, the next 5 curtains city-wide with venue/time/film, and dataset freshness per source. In "detailed" mode every showtime also carries its confidence level, source tier, reporting sources, and verified_at timestamp.
Inputs: response_format. Returns: sources, night_of, data_as_of, is_tonight, +5 more
scenef_plan_movie_nightPlan a movie nightARead-only
The concierge: give it a window and a taste profile and it returns 2-4 complete plans — film + specific showtime + theater + why it fits — each with ticket and calendar links, plus one wildcard pick outside the stated genres. Rankings are pure preference-fit; never pay-ranked. In "detailed" mode every showtime also carries its confidence level, source tier, reporting sources, and verified_at timestamp.
Inputs: when, party_size, preferences, response_format. Returns: note, plans, nights, window, +7 more
scenef_search_showtimesSearch showtimes for a filmARead-only
Showtimes scoped by FILM or by THEATER — pass at least one. With film: where that film is playing (title or slug; fuzzy-matched, ambiguous queries return candidates). With venues and no film: everything on at those theaters, each showtime naming its film. Grouped by theater with local times, tags (35mm/qa/sold-out), the night each show belongs to, and a ticket link per showtime. Optional date and time-window filters apply to both. For the whole board with no film or theater in mind, call scenef_whats_playing instead. In "detailed" mode every showtime also carries its confidence level, source tier, reporting sources, and verified_at timestamp.
Inputs: date, film, venues, time_after, +2 more. Returns: film, query, venues, matched, +9 more
scenef_theater_infoTheater infoARead-only
One SF theater's card: address, neighborhood, website, ticketing note, structured discounts (label/detail/day), amenities, its next 5 showtimes with ticket links, and its calendar feed url. In "detailed" mode every showtime also carries its confidence level, source tier, reporting sources, and verified_at timestamp.
Inputs: theater (required), response_format. Returns: query, venue, matched, upcoming, +6 more
scenef_whats_playingWhat's playing in SFARead-only
Ranked list of films playing San Francisco theaters in a given window (tonight, tomorrow, the weekend, or a date), with optional genre and format filters. When the window covers tonight, opens with Notable tonight — scarcity facts with evidence (measured seat counts, final nights, lone prints, posted discounts, live elements); lead with those when asked what to see. Each entry carries year, runtime, genres, a one-line hook, venue count, the next showtime, and the film's SceneF url. In "detailed" mode every showtime also carries its confidence level, source tier, reporting sources, and verified_at timestamp.
Inputs: when, genres, formats, max_results, +1 more. Returns: note, films, nights, window, +5 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a different query type—browse, search by film/theater, details, planning, discounts, coming soon, status, and accuracy—so misselection is unlikely. Minor overlap exists because film_details and theater_info include showtimes that search_showtimes also returns, but the descriptions clearly direct usage.
All names share the scenef_ prefix, use snake_case, and are descriptive of their function. However, the set mixes verb-led names like search_showtimes and plan_movie_night with noun-led names like theater_info and film_details, plus informal phrases like whats_playing and now.
Nine tools is well within the ideal range for a domain-specific server, and each tool covers a distinct facet of the movie-showtime workflow. None feel redundant or purely decorative.
The surface covers browsing, searching, details, planning, discounts, coming soon, and a quick status check, so core user journeys are supported. The main gap is the absence of a direct theater-listing or venue-discovery tool; theater_info and search_showtimes expect the agent to already know a venue.
Maintenance
Related MCP Connectors
Remote MCP utilities for agents: structured data, commerce checks, and x402 paid API discovery.
Query SEC EDGAR filings, XBRL financials, and company data via MCP. STDIO or Streamable HTTP.
Deterministic MCP, JSON Schema, and SemVer preflight via Agothe's public MUV scope.
Structured analysis API and remote MCP tool for text, JSON records and numeric series.
Related MCP Servers
- AlicenseAqualityDmaintenanceUnofficial, read-only MCP server for Fandango showtimes and seat availability, reverse-engineered from observed web traffic.462MIT
- FlicenseAqualityDmaintenanceMCP server that mirrors and historically archives the current cinema program of Movieplexx Buchholz, enabling queries for showtimes, film details, and history via SQLite-backed tools.5-
- AlicenseAqualityBmaintenanceZero-dependency stdio bridge to Moltline Studio's fleet of 14 hosted MCP servers covering code review, time operations, data transforms, business ops, education, research, outreach and more. Free tier requires no registration; premium tools unlock with a license. Independently audited, MCPize Verified A.10MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to query and manage Kitsu/Zou production data, including projects, shots, assets, tasks, people, previews, video review, and optional write actions, through an MCP interface. Supports local stdio use and hosted HTTP connectors with per-user Kitsu authentication and read-only defaults.64 PyPI1MIT