Skip to main content
Glama
SceneF — San Francisco Movie Showtimes

SceneF — San Francisco Movie Showtimes

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/mcp

Connect

Claude Code

claude mcp add --transport http scenef https://scenef.com/mcp

Claude 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-mcp

Claude Desktop / any stdio client

{
  "mcpServers": {
    "scenef": {
      "command": "npx",
      "args": ["-y", "github:speedwarnsf/scenef-mcp"]
    }
  }
}

From a clone, or Docker

npm install && npm start
docker build -t scenef-mcp . && docker run --rm -i scenef-mcp

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

scenef_now

Right-now snapshot: what's catchable at this hour

scenef_accuracy

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-feed and carry the weakest claim on the site. Every returned screening carries confidence, source_tier, sources, and verified_at in both concise and detailed modes.

  • data_as_of is the dataset publication time. verified_at and freshness describe 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

info@scenef.com · scenef.com

Available Tools

9 tools
scenef_accuracyThe accuracy recordA
Read-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)A
Read-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 gridA
Read-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 detailsA
Read-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 nowA
Read-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 nightA
Read-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 filmA
Read-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 infoA
Read-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 SFA
Read-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

    A4.2/5.0

    Scored across 9 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      MCP 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
      -
    • A
      license
      A
      quality
      B
      maintenance
      Zero-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.
      10
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 PyPI
      1
      MIT