SceneF — California, Florida and Hawaii Movie Showtimes

56 California, Florida and Hawaii movie boards: chains, indies, repertory. Verified daily. Free.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
93%
Qualität der Benennung
80%
Risiko der Vergiftung
80%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (2)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains URL to non-standard domainin scenef_accuracy

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~10,819Tokens (Tool-Definitionen)
~11.4 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (8.45% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "showtimes": {
      "url": "https://scenef.com/mcp"
    }
  }
}

Remote-Endpunkte

https://scenef.com/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (10)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢scenef_whats_playing(region, when, genres, formats, max_results, ...)

Ranked list of films playing California, Florida and Hawaii 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, showtime_count, the next showtime, and the film's SceneF url. The full per-showtime rows are in "detailed", or from scenef_search_showtimes scoped to one film or theatre. Every emitted showtime carries confidence, source tier, reporting sources and verified_at. In whats_playing, "concise" gives the total showtime_count and one next screening in showtimes; showtimes_complete identifies a partial array. "detailed" includes the full array.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "when": {
      "description": "When to look: \"tonight\" (default), \"tomorrow\", \"weekend\" (Fri/Sat/Sun of the current week), or a YYYY-MM-DD date.",
      "type": "string"
    },
    "genres": {
      "description": "Genre filters, e.g. [\"horror\", \"comedy\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "formats": {
      "description": "Format/tag filters, e.g. [\"35mm\", \"70mm\", \"qa\", \"live-score\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "max_results": {
      "description": "Max films to return (default 12, cap 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "window": {
      "type": "string"
    },
    "nights": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "notable": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "venue": {
            "type": "string"
          },
          "local_time": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "venue",
          "local_time"
        ],
        "additionalProperties": {}
      }
    },
    "film_count": {
      "type": "number"
    },
    "films": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "year": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "runtime_min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "genres": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "directors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "type": "string"
          },
          "venue_count": {
            "type": "number"
          },
          "showtime_count": {
            "type": "number"
          },
          "next_showtime": {
            "type": "object",
            "properties": {
              "screening_id": {
                "type": "string"
              },
              "venue": {
                "type": "object",
                "properties": {
                  "venue_id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "short": {
                    "type": "string"
                  },
                  "neighborhood": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "venue_id",
                  "name",
                  "short",
                  "neighborhood"
                ],
                "additionalProperties": {}
              },
              "starts_at": {
                "type": "string"
              },
              "night_of": {
                "type": "string"
              },
              "local_time": {
                "type": "string"
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "ticket_url": {
                "type": "string"
              },
              "calendar_url": {
                "type": "string"
              },
              "confidence": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "venue-published",
                      "corroborated",
                      "single-source",
                      "disputed"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "source_tier": {
                "type": "string"
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "verified_at": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "note": {
                "type": "string"
              },
              "freshness": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "current",
                      "stale",
                      "unknown"
                    ]
                  },
                  "age_hours": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "stale_after_hours": {
                    "type": "number"
                  },
                  "retained": {
                    "type": "boolean"
                  },
                  "source_status": {
                    "type": "string",
                    "enum": [
                      "ok",
                      "held",
                      "failed",
                      "unknown"
                    ]
                  }
                },
                "required": [
                  "status",
                  "age_hours",
                  "stale_after_hours",
                  "retained",
                  "source_status"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "screening_id",
              "venue",
              "starts_at",
              "night_of",
              "local_time",
              "tags",
              "ticket_url",
              "calendar_url",
              "confidence",
              "source_tier",
              "sources",
              "verified_at"
            ],
            "additionalProperties": {}
          },
          "showtimes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screening_id": {
                  "type": "string"
                },
                "venue": {
                  "type": "object",
                  "properties": {
                    "venue_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "short": {
                      "type": "string"
                    },
                    "neighborhood": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "venue_id",
                    "name",
                    "short",
                    "neighborhood"
                  ],
                  "additionalProperties": {}
                },
                "starts_at": {
                  "type": "string"
                },
                "night_of": {
                  "type": "string"
                },
                "local_time": {
                  "type": "string"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "ticket_url": {
                  "type": "string"
                },
                "calendar_url": {
                  "type": "string"
                },
                "confidence": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "venue-published",
                        "corroborated",
                        "single-source",
                        "disputed"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "source_tier": {
                  "type": "string"
                },
                "sources": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "verified_at": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "note": {
                  "type": "string"
                },
                "freshness": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "current",
                        "stale",
                        "unknown"
                      ]
                    },
                    "age_hours": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "stale_after_hours": {
                      "type": "number"
                    },
                    "retained": {
                      "type": "boolean"
                    },
                    "source_status": {
                      "type": "string",
                      "enum": [
                        "ok",
                        "held",
                        "failed",
                        "unknown"
                      ]
                    }
                  },
                  "required": [
                    "status",
                    "age_hours",
                    "stale_after_hours",
                    "retained",
                    "source_status"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "screening_id",
                "venue",
                "starts_at",
                "night_of",
                "local_time",
                "tags",
                "ticket_url",
                "calendar_url",
                "confidence",
                "source_tier",
                "sources",
                "verified_at"
              ],
              "additionalProperties": {}
            }
          },
          "showtimes_complete": {
            "type": "boolean",
            "description": "Whether showtimes includes all showtime_count screenings. Concise includes only the next screening; detailed includes all."
          }
        },
        "required": [
          "key",
          "slug",
          "title",
          "year",
          "runtime_min",
          "genres",
          "directors",
          "url",
          "venue_count",
          "showtime_count",
          "next_showtime",
          "showtimes",
          "showtimes_complete"
        ],
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "window",
    "nights",
    "note",
    "notable",
    "film_count",
    "films"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_search_showtimes(region, film, date, time_after, time_before, ...)

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. Every emitted showtime carries confidence, source tier, reporting sources and verified_at. In whats_playing, "concise" gives the total showtime_count and one next screening in showtimes; showtimes_complete identifies a partial array. "detailed" includes the full array.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "film": {
      "description": "Film title, or a SceneF slug taken from films[].slug / scenef_whats_playing. A title that is not on the board answers with a miss and points at scenef_whats_playing, so guessing is safe but browsing is faster. Optional when `venues` is given — omit it to ask what is on at a theater.",
      "type": "string"
    },
    "date": {
      "description": "Restrict to one night, YYYY-MM-DD.",
      "type": "string"
    },
    "time_after": {
      "description": "Only shows at or after this local time, \"HH:MM\" 24h.",
      "type": "string"
    },
    "time_before": {
      "description": "Only shows at or before this local time, \"HH:MM\" 24h.",
      "type": "string"
    },
    "venues": {
      "description": "Restrict to these theaters (ids or names), e.g. [\"roxie\", \"Balboa\"]. Required when `film` is omitted.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "matched": {
      "type": "boolean"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "filtered_by": {
      "type": "string",
      "enum": [
        "film",
        "venue"
      ]
    },
    "refusal": {
      "type": "string"
    },
    "film": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "year": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "runtime_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "genres": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "directors": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "url": {
          "type": "string"
        }
      },
      "required": [
        "key",
        "slug",
        "title",
        "year",
        "runtime_min",
        "genres",
        "directors",
        "url"
      ],
      "additionalProperties": {}
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "year": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "runtime_min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "genres": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "directors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "key",
          "slug",
          "title",
          "year",
          "runtime_min",
          "genres",
          "directors",
          "url"
        ],
        "additionalProperties": {}
      }
    },
    "unknown_venues": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "coverage_note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "showtime_count": {
      "type": "number"
    },
    "venues": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "venue_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "short": {
            "type": "string"
          },
          "neighborhood": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "showtimes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "screening_id": {
                  "type": "string"
                },
                "venue": {
                  "type": "object",
                  "properties": {
                    "venue_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "short": {
                      "type": "string"
                    },
                    "neighborhood": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "venue_id",
                    "name",
                    "short",
                    "neighborhood"
                  ],
                  "additionalProperties": {}
                },
                "starts_at": {
                  "type": "string"
                },
                "night_of": {
                  "type": "string"
                },
                "local_time": {
                  "type": "string"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "ticket_url": {
                  "type": "string"
                },
                "calendar_url": {
                  "type": "string"
                },
                "confidence": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "venue-published",
                        "corroborated",
                        "single-source",
                        "disputed"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "source_tier": {
                  "type": "string"
                },
                "sources": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "verified_at": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "note": {
                  "type": "string"
                },
                "freshness": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "current",
                        "stale",
                        "unknown"
                      ]
                    },
                    "age_hours": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "stale_after_hours": {
                      "type": "number"
                    },
                    "retained": {
                      "type": "boolean"
                    },
                    "source_status": {
                      "type": "string",
                      "enum": [
                        "ok",
                        "held",
                        "failed",
                        "unknown"
                      ]
                    }
                  },
                  "required": [
                    "status",
                    "age_hours",
                    "stale_after_hours",
                    "retained",
                    "source_status"
                  ],
                  "additionalProperties": false
                },
                "film": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "key": {
                          "type": "string"
                        },
                        "slug": {
                          "type": "string"
                        },
                        "title": {
                          "type": "string"
                        },
                        "year": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "runtime_min": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "genres": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "directors": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "key",
                        "slug",
                        "title",
                        "year",
                        "runtime_min",
                        "genres",
                        "directors",
                        "url"
                      ],
                      "additionalProperties": {}
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "screening_id",
                "venue",
                "starts_at",
                "night_of",
                "local_time",
                "tags",
                "ticket_url",
                "calendar_url",
                "confidence",
                "source_tier",
                "sources",
                "verified_at"
              ],
              "additionalProperties": {}
            }
          }
        },
        "required": [
          "venue_id",
          "name",
          "short",
          "neighborhood",
          "showtimes"
        ],
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "query",
    "matched",
    "warnings",
    "unknown_venues",
    "coverage_note",
    "showtime_count",
    "venues"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_theater_info(region, theater, response_format)

One 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. Every emitted showtime carries confidence, source tier, reporting sources and verified_at. In whats_playing, "concise" gives the total showtime_count and one next screening in showtimes; showtimes_complete identifies a partial array. "detailed" includes the full array.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "theater": {
      "type": "string",
      "description": "Theater id or name, e.g. \"roxie\" or \"Balboa Theater\"."
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "required": [
    "theater"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "matched": {
      "type": "boolean"
    },
    "venue": {
      "type": "object",
      "properties": {
        "venue_id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "short": {
          "type": "string"
        },
        "neighborhood": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "venue_id",
        "name",
        "short",
        "neighborhood"
      ],
      "additionalProperties": {}
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "venue_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "short": {
            "type": "string"
          },
          "neighborhood": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "venue_id",
          "name",
          "short",
          "neighborhood"
        ],
        "additionalProperties": {}
      }
    },
    "covered_venue_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "upcoming_count": {
      "type": "number"
    },
    "upcoming": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "screening_id": {
            "type": "string"
          },
          "venue": {
            "type": "object",
            "properties": {
              "venue_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "short": {
                "type": "string"
              },
              "neighborhood": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "venue_id",
              "name",
              "short",
              "neighborhood"
            ],
            "additionalProperties": {}
          },
          "starts_at": {
            "type": "string"
          },
          "night_of": {
            "type": "string"
          },
          "local_time": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ticket_url": {
            "type": "string"
          },
          "calendar_url": {
            "type": "string"
          },
          "confidence": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "venue-published",
                  "corroborated",
                  "single-source",
                  "disputed"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "source_tier": {
            "type": "string"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "verified_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "note": {
            "type": "string"
          },
          "freshness": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "current",
                  "stale",
                  "unknown"
                ]
              },
              "age_hours": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "stale_after_hours": {
                "type": "number"
              },
              "retained": {
                "type": "boolean"
              },
              "source_status": {
                "type": "string",
                "enum": [
                  "ok",
                  "held",
                  "failed",
                  "unknown"
                ]
              }
            },
            "required": [
              "status",
              "age_hours",
              "stale_after_hours",
              "retained",
              "source_status"
            ],
            "additionalProperties": false
          },
          "film": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "year": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "runtime_min": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "genres": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "directors": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "key",
                  "slug",
                  "title",
                  "year",
                  "runtime_min",
                  "genres",
                  "directors",
                  "url"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "screening_id",
          "venue",
          "starts_at",
          "night_of",
          "local_time",
          "tags",
          "ticket_url",
          "calendar_url",
          "confidence",
          "source_tier",
          "sources",
          "verified_at",
          "film"
        ],
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "query",
    "matched"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_film_details(region, film, response_format)

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. Every emitted showtime carries confidence, source tier, reporting sources and verified_at. In whats_playing, "concise" gives the total showtime_count and one next screening in showtimes; showtimes_complete identifies a partial array. "detailed" includes the full array.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "film": {
      "type": "string",
      "description": "Film title or SceneF slug."
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "required": [
    "film"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "matched": {
      "type": "boolean"
    },
    "film": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "year": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "runtime_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "genres": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "directors": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "url": {
          "type": "string"
        }
      },
      "required": [
        "key",
        "slug",
        "title",
        "year",
        "runtime_min",
        "genres",
        "directors",
        "url"
      ],
      "additionalProperties": {}
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "year": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "runtime_min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "genres": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "directors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "key",
          "slug",
          "title",
          "year",
          "runtime_min",
          "genres",
          "directors",
          "url"
        ],
        "additionalProperties": {}
      }
    },
    "final_night": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "is_last_night": {
      "type": "boolean"
    },
    "showtime_count": {
      "type": "number"
    },
    "showtimes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "screening_id": {
            "type": "string"
          },
          "venue": {
            "type": "object",
            "properties": {
              "venue_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "short": {
                "type": "string"
              },
              "neighborhood": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "venue_id",
              "name",
              "short",
              "neighborhood"
            ],
            "additionalProperties": {}
          },
          "starts_at": {
            "type": "string"
          },
          "night_of": {
            "type": "string"
          },
          "local_time": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ticket_url": {
            "type": "string"
          },
          "calendar_url": {
            "type": "string"
          },
          "confidence": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "venue-published",
                  "corroborated",
                  "single-source",
                  "disputed"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "source_tier": {
            "type": "string"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "verified_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "note": {
            "type": "string"
          },
          "freshness": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "current",
                  "stale",
                  "unknown"
                ]
              },
              "age_hours": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "stale_after_hours": {
                "type": "number"
              },
              "retained": {
                "type": "boolean"
              },
              "source_status": {
                "type": "string",
                "enum": [
                  "ok",
                  "held",
                  "failed",
                  "unknown"
                ]
              }
            },
            "required": [
              "status",
              "age_hours",
              "stale_after_hours",
              "retained",
              "source_status"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "screening_id",
          "venue",
          "starts_at",
          "night_of",
          "local_time",
          "tags",
          "ticket_url",
          "calendar_url",
          "confidence",
          "source_tier",
          "sources",
          "verified_at"
        ],
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "query",
    "matched"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_plan_movie_night(region, when, party_size, preferences, response_format)

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. Every emitted showtime carries confidence, source tier, reporting sources and verified_at. In whats_playing, "concise" gives the total showtime_count and one next screening in showtimes; showtimes_complete identifies a partial array. "detailed" includes the full array.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "when": {
      "description": "When to look: \"tonight\" (default), \"tomorrow\", \"weekend\" (Fri/Sat/Sun of the current week), or a YYYY-MM-DD date.",
      "type": "string"
    },
    "party_size": {
      "description": "How many people are going.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "preferences": {
      "description": "Bring-your-own taste profile. Everything here tilts the ranking and degrades gracefully EXCEPT time_after/time_before, which are hard bounds.",
      "type": "object",
      "properties": {
        "likes": {
          "description": "Genres to favor, e.g. [\"horror\", \"comedy\"].",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "avoids": {
          "description": "Genres to steer away from.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "window": {
          "description": "Preferred start-time window — a soft tilt. For a time you genuinely cannot make, use time_after/time_before instead.",
          "type": "string",
          "enum": [
            "matinee",
            "early",
            "evening",
            "late"
          ]
        },
        "time_after": {
          "description": "HARD earliest start, \"HH:MM\" local 24h, e.g. \"20:00\" for \"nothing before 8\". Unlike the other preferences this does NOT degrade: if nothing starts that late the tool says so rather than ranking a show you cannot get to.",
          "type": "string"
        },
        "time_before": {
          "description": "HARD latest start, \"HH:MM\" local 24h. Same no-fallback rule.",
          "type": "string"
        },
        "no_matinee": {
          "description": "Penalize daytime shows.",
          "type": "boolean"
        },
        "formats": {
          "description": "Formats to favor, e.g. [\"35mm\", \"70mm\"].",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "home_venues": {
          "description": "Home-theater venue ids to nudge upward, e.g. [\"roxie\"].",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "discounts_only": {
          "description": "Only screenings at theaters with a discount active that night.",
          "type": "boolean"
        }
      }
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "window": {
      "type": "string"
    },
    "nights": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "party_size": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "discounts_relaxed": {
      "type": "boolean"
    },
    "plan_count": {
      "type": "number"
    },
    "plans": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "is_wildcard": {
            "type": "boolean"
          },
          "score": {
            "type": "number"
          },
          "why": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "film": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "year": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "runtime_min": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "genres": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "directors": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "key",
                  "slug",
                  "title",
                  "year",
                  "runtime_min",
                  "genres",
                  "directors",
                  "url"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          },
          "showtime": {
            "type": "object",
            "properties": {
              "screening_id": {
                "type": "string"
              },
              "venue": {
                "type": "object",
                "properties": {
                  "venue_id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "short": {
                    "type": "string"
                  },
                  "neighborhood": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "venue_id",
                  "name",
                  "short",
                  "neighborhood"
                ],
                "additionalProperties": {}
              },
              "starts_at": {
                "type": "string"
              },
              "night_of": {
                "type": "string"
              },
              "local_time": {
                "type": "string"
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "ticket_url": {
                "type": "string"
              },
              "calendar_url": {
                "type": "string"
              },
              "confidence": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "venue-published",
                      "corroborated",
                      "single-source",
                      "disputed"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "source_tier": {
                "type": "string"
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "verified_at": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "note": {
                "type": "string"
              },
              "freshness": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "current",
                      "stale",
                      "unknown"
                    ]
                  },
                  "age_hours": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "stale_after_hours": {
                    "type": "number"
                  },
                  "retained": {
                    "type": "boolean"
                  },
                  "source_status": {
                    "type": "string",
                    "enum": [
                      "ok",
                      "held",
                      "failed",
                      "unknown"
                    ]
                  }
                },
                "required": [
                  "status",
                  "age_hours",
                  "stale_after_hours",
                  "retained",
                  "source_status"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "screening_id",
              "venue",
              "starts_at",
              "night_of",
              "local_time",
              "tags",
              "ticket_url",
              "calendar_url",
              "confidence",
              "source_tier",
              "sources",
              "verified_at"
            ],
            "additionalProperties": {}
          }
        },
        "required": [
          "is_wildcard",
          "score",
          "why",
          "film",
          "showtime"
        ],
        "additionalProperties": {}
      }
    },
    "wildcard": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "why": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "showtime": {
              "type": "object",
              "properties": {
                "screening_id": {
                  "type": "string"
                },
                "venue": {
                  "type": "object",
                  "properties": {
                    "venue_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "short": {
                      "type": "string"
                    },
                    "neighborhood": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "venue_id",
                    "name",
                    "short",
                    "neighborhood"
                  ],
                  "additionalProperties": {}
                },
                "starts_at": {
                  "type": "string"
                },
                "night_of": {
                  "type": "string"
                },
                "local_time": {
                  "type": "string"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "ticket_url": {
                  "type": "string"
                },
                "calendar_url": {
                  "type": "string"
                },
                "confidence": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "venue-published",
                        "corroborated",
                        "single-source",
                        "disputed"
                      ]
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "source_tier": {
                  "type": "string"
                },
                "sources": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "verified_at": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "note": {
                  "type": "string"
                },
                "freshness": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "current",
                        "stale",
                        "unknown"
                      ]
                    },
                    "age_hours": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "stale_after_hours": {
                      "type": "number"
                    },
                    "retained": {
                      "type": "boolean"
                    },
                    "source_status": {
                      "type": "string",
                      "enum": [
                        "ok",
                        "held",
                        "failed",
                        "unknown"
                      ]
                    }
                  },
                  "required": [
                    "status",
                    "age_hours",
                    "stale_after_hours",
                    "retained",
                    "source_status"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "screening_id",
                "venue",
                "starts_at",
                "night_of",
                "local_time",
                "tags",
                "ticket_url",
                "calendar_url",
                "confidence",
                "source_tier",
                "sources",
                "verified_at"
              ],
              "additionalProperties": {}
            }
          },
          "required": [
            "why",
            "showtime"
          ],
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "window",
    "nights",
    "party_size",
    "note",
    "warnings",
    "discounts_relaxed",
    "plan_count",
    "plans",
    "wildcard"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_discounts(region, response_format)

Every structured discount across one board's theaters — venue, label, detail, and day-bound days — with the ones that apply today flagged.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "today_dow": {
      "type": "number"
    },
    "today_name": {
      "type": "string"
    },
    "applies_today_count": {
      "type": "number"
    },
    "venues": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "venue_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "short": {
            "type": "string"
          },
          "neighborhood": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "discounts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "day": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "detail": {
                  "type": "string"
                },
                "applies_today": {
                  "type": "boolean"
                }
              },
              "required": [
                "label",
                "kind",
                "day",
                "detail",
                "applies_today"
              ],
              "additionalProperties": {}
            }
          }
        },
        "required": [
          "venue_id",
          "name",
          "short",
          "neighborhood",
          "discounts"
        ],
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "today_dow",
    "today_name",
    "applies_today_count",
    "venues"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_coming_soon(region, horizon_days, response_format)

Films whose first screening on this board is more than 48 hours out, sorted by first night — the on-sale radar for runs worth booking early. Configurable horizon. Every emitted showtime carries confidence, source tier, reporting sources and verified_at. In whats_playing, "concise" gives the total showtime_count and one next screening in showtimes; showtimes_complete identifies a partial array. "detailed" includes the full array.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "horizon_days": {
      "description": "How far ahead to look (default 21 days).",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "horizon_days": {
      "type": "number"
    },
    "film_count": {
      "type": "number"
    },
    "films": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "year": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "runtime_min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "genres": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "directors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "type": "string"
          },
          "first_night": {
            "type": "string"
          },
          "opening_venues": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "key",
          "slug",
          "title",
          "year",
          "runtime_min",
          "genres",
          "directors",
          "url",
          "first_night",
          "opening_venues"
        ],
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "horizon_days",
    "film_count",
    "films"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_resolve_board(place)

Translate a city, 5-digit ZIP, neighborhood or board alias into the region handle every other tool takes. Returns the board and WHAT matched it. Refuses rather than guessing: an ambiguous name returns candidates (Gainesville is a town in Texas and another in Florida), a place we cover but have not published returns outside_coverage with the nearest published boards, and an unknown string returns unknown with no fallback board. Coordinates are not accepted — this reads names, not locations.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string",
      "description": "A city (\"Pasadena\"), a 5-digit ZIP (\"94121\"), a neighborhood (\"the Mission\") or a board alias (\"the East Bay\", \"sf\")."
    }
  },
  "required": [
    "place"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "input": {
      "type": "string"
    },
    "matched": {
      "type": "string",
      "enum": [
        "city",
        "zip",
        "neighborhood",
        "alias"
      ]
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "enum": [
        "ambiguous",
        "outside_coverage",
        "unknown"
      ]
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "region": {
            "type": "string"
          },
          "region_name": {
            "type": "string"
          },
          "why": {
            "type": "string"
          }
        },
        "required": [
          "region",
          "region_name",
          "why"
        ],
        "additionalProperties": false
      }
    },
    "nearest_lit": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "region": {
            "type": "string"
          },
          "region_name": {
            "type": "string"
          },
          "miles": {
            "type": "number"
          }
        },
        "required": [
          "region",
          "region_name",
          "miles"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "ok",
    "input"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_now(region, response_format)

The cheap is-anything-on call: how many screenings tonight, the next 5 curtains across this board with venue/time/film, and dataset freshness per source. Every emitted showtime carries confidence, source tier, reporting sources and verified_at. In whats_playing, "concise" gives the total showtime_count and one next screening in showtimes; showtimes_complete identifies a partial array. "detailed" includes the full array.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "night_of": {
      "type": "string"
    },
    "is_tonight": {
      "type": "boolean"
    },
    "screenings_tonight": {
      "type": "number"
    },
    "still_to_come": {
      "type": "number"
    },
    "next_curtains": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "screening_id": {
            "type": "string"
          },
          "venue": {
            "type": "object",
            "properties": {
              "venue_id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "short": {
                "type": "string"
              },
              "neighborhood": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "venue_id",
              "name",
              "short",
              "neighborhood"
            ],
            "additionalProperties": {}
          },
          "starts_at": {
            "type": "string"
          },
          "night_of": {
            "type": "string"
          },
          "local_time": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ticket_url": {
            "type": "string"
          },
          "calendar_url": {
            "type": "string"
          },
          "confidence": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "venue-published",
                  "corroborated",
                  "single-source",
                  "disputed"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "source_tier": {
            "type": "string"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "verified_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "note": {
            "type": "string"
          },
          "freshness": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "current",
                  "stale",
                  "unknown"
                ]
              },
              "age_hours": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "stale_after_hours": {
                "type": "number"
              },
              "retained": {
                "type": "boolean"
              },
              "source_status": {
                "type": "string",
                "enum": [
                  "ok",
                  "held",
                  "failed",
                  "unknown"
                ]
              }
            },
            "required": [
              "status",
              "age_hours",
              "stale_after_hours",
              "retained",
              "source_status"
            ],
            "additionalProperties": false
          },
          "film": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "year": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "runtime_min": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "genres": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "directors": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "key",
                  "slug",
                  "title",
                  "year",
                  "runtime_min",
                  "genres",
                  "directors",
                  "url"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "screening_id",
          "venue",
          "starts_at",
          "night_of",
          "local_time",
          "tags",
          "ticket_url",
          "calendar_url",
          "confidence",
          "source_tier",
          "sources",
          "verified_at",
          "film"
        ],
        "additionalProperties": {}
      }
    },
    "boards": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "region": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "timezone": {
            "type": "string"
          }
        },
        "required": [
          "region",
          "name",
          "timezone"
        ],
        "additionalProperties": false
      }
    },
    "sources": {
      "type": "object",
      "properties": {
        "healthy": {
          "type": "number"
        },
        "total": {
          "type": "number"
        }
      },
      "required": [
        "healthy",
        "total"
      ],
      "additionalProperties": {}
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "night_of",
    "is_tonight",
    "screenings_tonight",
    "still_to_come",
    "next_curtains",
    "boards",
    "sources"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢scenef_accuracy(region, response_format)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "Which regional board to read, e.g. \"sf\", \"oahu\", \"sacramento\". Omitted means the default board — it is never inferred from where you are. Call scenef_now for the full list; an unknown region is an error, not a fallback.",
      "type": "string"
    },
    "response_format": {
      "description": "Output size. \"concise\" (default) is tight text plus a structured summary. In whats_playing, each film has the total showtime_count, next_showtime, and a showtimes array containing only that next screening; showtimes_complete says whether the array is exhaustive. \"detailed\" includes all selected showtime rows with ids, ticket urls, and accuracy metadata. Use scenef_search_showtimes for all times for one film or theatre.",
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "data_as_of": {
      "type": "string"
    },
    "attribution": {
      "type": "string"
    },
    "accuracy_url": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "region_name": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "site": {
      "type": "object",
      "properties": {
        "checks": {
          "type": "number"
        },
        "confirmed": {
          "type": "number"
        },
        "missing": {
          "type": "number"
        },
        "unreachable": {
          "type": "number"
        },
        "pass_rate": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "window_days": {
          "type": "number"
        },
        "pass_rate_basis": {
          "type": "string"
        },
        "screenings": {
          "type": "number"
        },
        "confidence_mix": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "number"
          }
        }
      },
      "required": [
        "checks",
        "confirmed",
        "missing",
        "unreachable",
        "pass_rate",
        "window_days",
        "pass_rate_basis",
        "screenings",
        "confidence_mix"
      ],
      "additionalProperties": {}
    },
    "venues": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "venue_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "source_tier": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "screenings": {
            "type": "number"
          },
          "confidence_mix": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "number"
            }
          },
          "last_verified_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "checks": {
            "type": "number"
          },
          "pass_rate": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "venue_id",
          "name",
          "source_tier",
          "screenings",
          "confidence_mix",
          "last_verified_at",
          "checks",
          "pass_rate"
        ],
        "additionalProperties": {}
      }
    },
    "method": {
      "type": "object",
      "properties": {
        "rings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "confidence_levels": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "string"
          }
        }
      },
      "required": [
        "rings",
        "confidence_levels"
      ],
      "additionalProperties": {}
    },
    "docs": {
      "type": "string"
    }
  },
  "required": [
    "data_as_of",
    "attribution",
    "accuracy_url",
    "region",
    "region_name",
    "timezone",
    "site",
    "venues",
    "method",
    "docs"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet10 Tools
verifiziertVersion nicht aufgezeichnet10 Tools