Dolby Cinema Tracker MCP
An MCP server that allows AI agents to search AMC premium showtimes, manage release plans, set up alerts for new showings, and handle subscription billing via Stripe, while keeping payment processing and ticket booking in the hands of the human user.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
alerts:write and every planner tool need the plan (402 subscription-required otherwise)
MCP endpoint (Streamable HTTP)
https://dolbycinematracker.xyz/mcpWhat its tools do
34 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (15)
Can change data (19)
start_plannerset_home_theatresset_reminderdelete_reminderset_tierset_format_preferencerequest_bookingcancel_booking_requestcreate_checkout_linkcreate_billing_portal_linkcreate_alertupdate_alertpause_alertresume_alertdelete_alertupdate_notification_settingsrevoke_this_tokenreissue_claimstart_subscription
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to dolbycinematracker.xyz ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search AMC premium showtimes and double features
- Set up a release planner with preferred theatres and formats
- Manage subscription status and billing via Stripe
- Receive alerts for new showtimes in preferred formats
Source and maintenance
Vendor evidenceRegistry 1.1.0
Protocol and capabilities
- Server
- dolby-cinema-tracker 2.0.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 34 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
34 advertised
start_planner — Start a release planner
Open-world
For a person without an account: creates their planner (new-showtime alerts and reminders included), a private agent token and a Stripe Checkout link. $4.99/mo after a 7-day free trial; everything included; the human confirms on Stripe; agents never handle cards. Show checkoutUrl to the human. After they confirm, Stripe returns them to a one-time link (24 hours) that saves their planner key in their browser; if they lose it before opening it, reissue_claim makes a new one. Keep agentToken private and poll get_subscription_status until entitled, then use the planner tools. Returns not_found while planner sign-ups are closed. Do not call repeatedly or for an existing owner.
start_planner input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string",
"default": "My AI agent",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}start_planner output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"checkoutUrl",
"agentToken",
"status"
],
"properties": {
"status": {
"type": "string",
"const": "pending_payment"
},
"agentToken": {
"type": "string"
},
"checkoutUrl": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}start_planner annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}list_releases — List releases to plan
Advertised read-only
Upcoming catalog releases with your saved tier and suggest-v1 suggestion. Needs a connected account with the plan: the token from start_planner or one made at /agents (401 connection-required without it). Filter by from/to (releaseDate), query (case-insensitive title search), format and untieredOnly; limit defaults to 50 (max 200) and total counts every match. Releases opening today or later come first, then those at the most theatres. releaseDate is AMC's release date or, when AMC has none, the earliest local showing date (the film's own, or its special screenings' when it has none); dateSource says which (amc or first-showing). Special screenings (Early Access, Fan Event, Q&A, anniversary, Insider, Opening Night and similar) appear under their base film as screenings [{id, label}]; one whose base film isn't in the catalog is its own release. Suggestions are advice, never intent. filmId is the AMC movie id and stays the same when the film joins your plan: pass it, or a screening's id, to set_tier, set_format_preference, get_plan, get_best_showings and request_booking. Planner responses name each film's filmId (the planner's own) and amcMovieId (this id).
list_releases input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Latest releaseDate (YYYY-MM-DD)."
},
"from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Earliest releaseDate (YYYY-MM-DD)."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Case-insensitive title search; also matches special screenings' titles."
},
"format": {
"enum": [
"dolby",
"imax",
"prime",
"3d",
"laser",
"digital",
"other"
],
"type": "string",
"description": "Only releases with upcoming listed showings in this format."
},
"untieredOnly": {
"type": [
"boolean",
"string"
],
"description": "Only releases without a tier on your plan."
}
},
"additionalProperties": false
}list_releases output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"releases",
"total"
],
"properties": {
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"releases": {
"type": "array",
"items": {
"type": "object",
"required": [
"filmId",
"title",
"releaseDate",
"dateSource",
"tier",
"suggestion",
"screenings"
],
"properties": {
"tier": {
"anyOf": [
{
"enum": [
"top",
"want",
"maybe",
"skip",
"seen",
"declined"
],
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"filmId": {
"type": "string",
"description": "The AMC movie id, the same before and after the film joins your plan. Every planner tool accepts it."
},
"dateSource": {
"anyOf": [
{
"enum": [
"amc",
"first-showing"
],
"type": "string"
},
{
"type": "null"
}
]
},
"screenings": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"description": "The special screening's AMC movie id."
},
"label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"suggestion": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "null"
}
]
},
"releaseDate": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}list_releases annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}set_home_theatres — Set your home theatres
Choose 1–10 active AMC theatre IDs. Rankings use only these theatres. Never creates booking intent or notification consent.
set_home_theatres input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"theatreIds"
],
"properties": {
"theatreIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"maxItems": 10,
"minItems": 1
}
},
"additionalProperties": false
}set_home_theatres output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}set_home_theatres annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}list_reminders — List your reminders
Advertised read-only
List only your reminders and their configured delivery source. Requires alerts:write.
list_reminders input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}list_reminders output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reminders"
],
"properties": {
"reminders": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"targetId",
"event",
"dueAt",
"expiresAt",
"title",
"url",
"deliverySubscriptionId",
"queuedAt"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"url": {
"type": "string"
},
"kind": {
"enum": [
"ticket",
"movie"
],
"type": "string"
},
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"event": {
"enum": [
"before-ticket",
"on-sale",
"first-showing"
],
"type": "string"
},
"title": {
"type": "string"
},
"queuedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"targetId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"expiresAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"deliverySubscriptionId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}list_reminders annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}set_reminder — Set a movie or booked-ticket reminder
Remind before an already booked planner ticket, or at an explicit human-selected on-sale/first-showing date and time for a known movie. Movie dates are supplied facts, never predictions. Uses an existing owned Following alert's confirmed email/registered push, and respects quiet hours even for on-sale. Does not book or create notification consent.
set_reminder input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"deliverySubscriptionId"
],
"properties": {
"at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"kind": {
"enum": [
"ticket",
"movie"
],
"type": "string"
},
"event": {
"enum": [
"on-sale",
"first-showing"
],
"type": "string"
},
"movieId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"ticketId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"minutesBefore": {
"type": "integer",
"maximum": 10080,
"minimum": 1
},
"deliverySubscriptionId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}set_reminder output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reminder"
],
"properties": {
"reminder": {
"type": "object",
"required": [
"id",
"kind",
"targetId",
"event",
"dueAt",
"expiresAt",
"title",
"url",
"deliverySubscriptionId",
"queuedAt"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"url": {
"type": "string"
},
"kind": {
"enum": [
"ticket",
"movie"
],
"type": "string"
},
"dueAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"event": {
"enum": [
"before-ticket",
"on-sale",
"first-showing"
],
"type": "string"
},
"title": {
"type": "string"
},
"queuedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"targetId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"expiresAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"deliverySubscriptionId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}set_reminder annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}delete_reminder — Delete your reminder
Advertised destructive
Delete only your reminder and expire any still-pending delivery. Does not alter tickets or follows.
delete_reminder input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}delete_reminder output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"deleted"
],
"properties": {
"deleted": {
"type": "boolean"
}
},
"additionalProperties": false
}delete_reminder annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}get_plan — Get your movie plan
Advertised read-only
Read your private plan, protected booked tickets, requests and as-planned capacity. Every film and plan names both ids: filmId (the planner's own) and amcMovieId (the filmId list_releases gives; null for a film without an AMC match). Pass filmId, the filmId from list_releases or the planner's own, to list only that film in films, plans, tickets, bookingRequests and suggestions. Never creates booking intent.
get_plan input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"filmId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1,
"description": "Use the filmId from list_releases (the AMC movie id); the planner's own film id from get_plan works too."
}
},
"additionalProperties": false
}get_plan output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}get_plan annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_capacity — Get as-planned capacity
Advertised read-only
Read planner capacity, not live AMC eligibility. Available to every planner owner.
get_capacity input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}get_capacity output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"capacity"
],
"properties": {
"capacity": {
"$ref": "#/definitions/__schema0"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}get_capacity annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_best_showings — Rank showings for your plan
Advertised read-only
Rank existing showings of a film (use the filmId from list_releases) at the owner's home theatres with the same planner eligibility, protected ticket conflicts and format preferences. Formats missing from the owner's format order rank after every listed one, with the reason "<format> (not in your list)". formatsScheduled lists the formats with upcoming listed showings of the film at those theatres; note says when a format the owner prefers is offered there but isn't scheduled for this film yet (new showtimes are checked every 3 hours), else null. Names both ids (filmId and amcMovieId). Returns the whole ranking (at most 600, flagged truncated), never paged. Does not queue or book.
get_best_showings input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"filmId"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"filmId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1,
"description": "Use the filmId from list_releases (the AMC movie id); the planner's own film id from get_plan works too."
}
},
"additionalProperties": false
}get_best_showings output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"filmId",
"amcMovieId",
"formatsScheduled",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "Set when a preferred format offered at the home theatres isn't scheduled for this film yet."
},
"filmId": {
"type": "string"
},
"amcMovieId": {
"type": [
"string",
"null"
]
},
"formatsScheduled": {
"type": "array",
"items": {
"enum": [
"dolby",
"imax",
"prime",
"3d",
"laser",
"digital",
"other"
],
"type": "string"
},
"description": "Formats with upcoming listed showings of this film at the home theatres."
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}get_best_showings annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}set_tier — Set a movie's planner tier
Set top, want, maybe, skip, seen or declined for a film (use the filmId from list_releases) using existing rules. The returned plan names both ids (filmId and amcMovieId). Top is only for films whose tickets are locked in: booked Top tickets are never released, cancelled, swapped or unprotected by any agent or automation, and a Top film with an upcoming locked ticket can't be moved out of Top (409 locked_top_ticket). Use want for anything you'd like to see. Does not create a booking request.
set_tier input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"filmId",
"tier"
],
"properties": {
"tier": {
"enum": [
"top",
"want",
"maybe",
"skip",
"seen",
"declined"
],
"type": "string"
},
"notes": {
"type": "string",
"maxLength": 4000
},
"filmId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1,
"description": "Use the filmId from list_releases (the AMC movie id); the planner's own film id from get_plan works too."
}
},
"additionalProperties": false
}set_tier output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}set_tier annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}set_format_preference — Set planner format preference
Set the default format order and explicit 3D permission. With filmId (use the filmId from list_releases), set that film's own order instead, which needs the film on your plan (set_tier first) and returns its plan with both ids. Formats left out rank after every listed one. Never books or modifies protected tickets.
set_format_preference input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"formatOrder",
"allow3d"
],
"properties": {
"filmId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1,
"description": "Only this film's order: use the filmId from list_releases (the planner's own id works too)."
},
"allow3d": {
"type": "boolean"
},
"formatOrder": {
"type": "array",
"items": {
"enum": [
"dolby",
"imax",
"prime",
"3d",
"laser",
"digital",
"other"
],
"type": "string"
},
"maxItems": 7,
"minItems": 1
}
},
"additionalProperties": false
}set_format_preference output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}set_format_preference annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}request_booking — Explicitly request a booking
Private executor accounts only. Only call when the human explicitly asks to queue a booking. Supply the film (use the filmId from list_releases), a selected showing OR complete flexibility and a stable clientKey for retries. Creates intent only, never a booking, charge or AMC call. Your booking assistant alone executes it and enforces zero-only.
request_booking input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"clientKey",
"filmId"
],
"properties": {
"filmId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1,
"description": "Use the filmId from list_releases (the AMC movie id); the planner's own film id from get_plan works too."
},
"clientKey": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"flexibility": {
"type": "object",
"required": [
"dateWindow",
"allowedFormats",
"allow3d",
"earliestLocalTime",
"latestLocalTime",
"theatres"
],
"properties": {
"allow3d": {
"type": "boolean"
},
"theatres": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100
},
"dateWindow": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
}
},
"additionalProperties": false
},
"allowedFormats": {
"type": "array",
"items": {
"enum": [
"dolby",
"imax",
"prime",
"3d",
"laser",
"digital",
"other"
],
"type": "string"
},
"maxItems": 7,
"minItems": 1
},
"latestLocalTime": {
"type": "string",
"pattern": "^\\d\\d:\\d\\d$"
},
"earliestLocalTime": {
"type": "string",
"pattern": "^\\d\\d:\\d\\d$"
}
},
"additionalProperties": false
},
"selectedShowtimeId": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}request_booking output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"bookingRequest"
],
"properties": {
"bookingRequest": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}request_booking annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}cancel_booking_request — Cancel a queued booking request
Private executor accounts only. Cancel only a still-queued request at its current revision. Cannot cancel a claimed request, a booked ticket or any protected ticket.
cancel_booking_request input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"revision"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"revision": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
}
},
"additionalProperties": false
}cancel_booking_request output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}cancel_booking_request annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}search_showtimes — Search AMC showtimes
Advertised read-only
Find collected showtimes by movie, theatre, ZIP and radius (miles), format or date range. Each row preserves IDs and includes movieTitle, theatreName, theatreCity, theatreState and the observed formatLabel; unknown display facts are null. Prices and coverage are observations, not guarantees; confirm with AMC.
search_showtimes input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}$"
},
"page": {
"type": "integer",
"default": 1,
"maximum": 100000,
"minimum": 1
},
"movie": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"format": {
"type": "string",
"maxLength": 100
},
"radius": {
"type": "number",
"default": 60,
"maximum": 200,
"minimum": 1
},
"theatre": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"pageSize": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}search_showtimes output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"items",
"total",
"page",
"pageSize",
"coverage",
"freshness"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"movieId",
"movieTitle",
"theatreId",
"theatreName",
"theatreCity",
"theatreState",
"formatLabel"
],
"properties": {
"movieId": {
"type": "string"
},
"theatreId": {
"type": [
"string",
"null"
],
"description": "Showing theatre ID, or the first-bookable evidence theatre for an on-sale aggregate."
},
"movieTitle": {
"type": [
"string",
"null"
]
},
"formatLabel": {
"type": [
"string",
"null"
],
"description": "Observed showing format label, or the first-bookable evidence's label for an on-sale aggregate; null when unknown."
},
"theatreCity": {
"type": [
"string",
"null"
]
},
"theatreName": {
"type": [
"string",
"null"
]
},
"theatreState": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"coverage": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"freshness": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}search_showtimes annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_drops — List new ticket drops
Advertised read-only
Find newly observed premium showings or new on-sale evidence since an absolute ISO time, with IDs, movieTitle, theatreName, theatreCity, theatreState and formatLabel. On-sale movie aggregates retain their nested evidence; top-level theatre/format displays identify firstBookableEvidence, or are null when unknown. This is collected evidence, not a complete real-time feed.
list_drops input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"since"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}$"
},
"kind": {
"enum": [
"premium",
"on-sale",
"all"
],
"type": "string",
"default": "all"
},
"page": {
"type": "integer",
"default": 1,
"maximum": 100000,
"minimum": 1
},
"movie": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"since": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"format": {
"type": "string",
"maxLength": 100
},
"radius": {
"type": "number",
"default": 60,
"maximum": 200,
"minimum": 1
},
"theatre": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"pageSize": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}list_drops output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"items",
"total",
"page",
"pageSize",
"coverage",
"freshness"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"movieId",
"movieTitle",
"theatreId",
"theatreName",
"theatreCity",
"theatreState",
"formatLabel"
],
"properties": {
"movieId": {
"type": "string"
},
"theatreId": {
"type": [
"string",
"null"
],
"description": "Showing theatre ID, or the first-bookable evidence theatre for an on-sale aggregate."
},
"movieTitle": {
"type": [
"string",
"null"
]
},
"formatLabel": {
"type": [
"string",
"null"
],
"description": "Observed showing format label, or the first-bookable evidence's label for an on-sale aggregate; null when unknown."
},
"theatreCity": {
"type": [
"string",
"null"
]
},
"theatreName": {
"type": [
"string",
"null"
]
},
"theatreState": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"coverage": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"pageSize": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"freshness": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}list_drops annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_movie — Get movie details
Advertised read-only
Get the collected movie record by movie ID or slug. Use search_showtimes for its showings.
get_movie input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"movie"
],
"properties": {
"movie": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}get_movie output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"movie"
],
"properties": {
"movie": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}get_movie annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_theatres — Find AMC theatres
Advertised read-only
Find active collected AMC theatres by name/city, ZIP and radius in miles. Theatre capabilities do not establish an individual showing's format.
find_theatres input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}$"
},
"query": {
"type": "string",
"maxLength": 160
},
"radius": {
"type": "number",
"default": 60,
"maximum": 200,
"minimum": 1
}
},
"additionalProperties": false
}find_theatres output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"theatres"
],
"properties": {
"theatres": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}find_theatres annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_double_features — Find double features
Advertised read-only
Find same-theatre movie pairs for one theatre and date using the site's pairing engine. Travel, runtime and trailer estimates are not guarantees; this never books tickets.
find_double_features input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"theatre",
"date"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"movie": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"format": {
"type": "string",
"maxLength": 100
},
"maxGap": {
"type": "integer",
"maximum": 240,
"minimum": 0
},
"minGap": {
"type": "integer",
"maximum": 240,
"minimum": 0
},
"theatre": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}find_double_features output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pairs"
],
"properties": {
"pairs": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}find_double_features annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_pricing — Get subscription pricing
Advertised read-only
Read the current configured price of the one plan: the release planner, new-showtime alerts and reminders, with a 7-day free trial for new subscribers. Public facts are free. Payment always requires a human to open and confirm a Stripe-hosted Checkout URL.
get_pricing input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}get_pricing output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"enabled",
"mode",
"price"
],
"properties": {
"mode": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"unitAmount",
"currency",
"interval"
],
"properties": {
"currency": {
"type": "string"
},
"interval": {
"type": "string"
},
"unitAmount": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"reason": {
"type": [
"string",
"null"
]
},
"enabled": {
"type": "boolean"
}
},
"additionalProperties": false
}get_pricing annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_subscription_status — Get subscription status
Advertised read-only
Check whether the connected owner has the plan (planner, alerts and reminders), including during the free trial, before payment or after expiry. Does not charge or modify billing.
get_subscription_status input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}get_subscription_status output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"status",
"entitled",
"billingState",
"currentPeriodEnd",
"cancelAtPeriodEnd"
],
"properties": {
"offer": {
"anyOf": [
{
"type": "object",
"required": [
"trialEndsAt"
],
"properties": {
"trialEndsAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"chargeToday"
],
"properties": {
"chargeToday": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
}
],
"description": "Grace owners only: what Checkout will do. trialEndsAt: no charge until then; chargeToday: the card is charged at Checkout."
},
"status": {
"type": "string"
},
"entitled": {
"type": "boolean"
},
"billingState": {
"enum": [
"subscribed",
"grace",
"comped",
"none"
],
"type": "string",
"description": "subscribed: manage in the billing portal; grace: Checkout keeps the free-trial end; comped: included, no billing; none: Checkout."
},
"currentPeriodEnd": {
"type": [
"number",
"null"
]
},
"cancelAtPeriodEnd": {
"type": "boolean"
}
},
"additionalProperties": false
}get_subscription_status annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_checkout_link — Create Stripe Checkout link
Open-world
Help the connected owner start the plan or renew it; new subscribers get the 7-day free trial. Return the Stripe-hosted URL to the human and ask them to open it and confirm. Never claim payment is complete.
create_checkout_link input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}create_checkout_link output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}create_checkout_link annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}create_billing_portal_link — Create billing portal link
Open-world
Return the connected owner's Stripe-hosted portal URL. The human opens it to view invoices, change payment details or cancel. This tool never cancels or charges.
create_billing_portal_link input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}create_billing_portal_link output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}create_billing_portal_link annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}list_alerts — List your alerts
Advertised read-only
List only the connected owner's saved follows and their current status. Requires read scope.
list_alerts input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}list_alerts output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"subscriptions",
"managementScope"
],
"properties": {
"subscriptions": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"managementScope": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}list_alerts annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_alert — Follow a movie
Create a movie follow with theatre IDs, formats, triggers and cadence using the website's validation and limits. Requires alerts:write and a paid plan. Email needs explicit human consent and confirmation; payment is not delivery consent.
create_alert input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"movie"
],
"properties": {
"email": {
"anyOf": [
{
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
{
"type": "null"
}
]
},
"movie": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"browser": {
"type": "boolean"
},
"cadence": {
"enum": [
"instant",
"daily",
"weekly"
],
"type": "string",
"default": "daily"
},
"formats": {
"type": "array",
"items": {
"enum": [
"premium",
"dolby",
"imax",
"prime",
"3d",
"laser",
"digital",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 8
},
"theatres": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 100
},
"timezone": {
"type": "string",
"default": "UTC",
"maxLength": 100
},
"triggers": {
"type": "array",
"items": {
"enum": [
"on-sale-near",
"new-showtimes",
"reopened"
],
"type": "string"
},
"default": [
"on-sale-near",
"new-showtimes"
],
"maxItems": 3,
"minItems": 1
},
"emailConsent": {
"type": "boolean"
}
},
"additionalProperties": false
}create_alert output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"subscription"
],
"properties": {
"confirmation": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"subscription": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}create_alert annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}update_alert — Update an alert
Update a saved follow's theatres, formats, triggers or cadence without changing omitted preferences. Only the connected owner's alert can be edited. Requires an entitled owner and alerts:write.
update_alert input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"email": {
"anyOf": [
{
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
{
"type": "null"
}
]
},
"browser": {
"type": "boolean"
},
"cadence": {
"enum": [
"instant",
"daily",
"weekly"
],
"type": "string"
},
"formats": {
"type": "array",
"items": {
"enum": [
"premium",
"dolby",
"imax",
"prime",
"3d",
"laser",
"digital",
"other"
],
"type": "string"
},
"maxItems": 8
},
"theatres": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100
},
"timezone": {
"type": "string",
"maxLength": 100
},
"triggers": {
"type": "array",
"items": {
"enum": [
"on-sale-near",
"new-showtimes",
"reopened"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
},
"emailConsent": {
"type": "boolean"
}
},
"additionalProperties": false
}update_alert output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"subscription"
],
"properties": {
"confirmation": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"subscription": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}update_alert annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}pause_alert — Pause an alert
Pause only the connected owner's alert. Requires alerts:write and a paid plan.
pause_alert input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}pause_alert output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"subscription"
],
"properties": {
"confirmation": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"subscription": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}pause_alert annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}resume_alert — Resume an alert
Resume only the connected owner's paused alert. Requires alerts:write and a paid plan; no paused-period backlog is sent.
resume_alert input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}resume_alert output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"subscription"
],
"properties": {
"confirmation": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"subscription": {
"type": "object",
"properties": {},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
}resume_alert annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}delete_alert — Delete an alert
Advertised destructive
Permanently delete only the connected owner's alert. This does not cancel the subscription. Requires alerts:write and a paid plan.
delete_alert input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}delete_alert output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"deleted",
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[\\w-]+$",
"maxLength": 100,
"minLength": 1
},
"deleted": {
"type": "boolean"
}
},
"additionalProperties": false
}delete_alert annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}get_notification_settings — Get notification settings
Advertised read-only
Read the connected owner's email/push preferences, timezone, quiet hours and digest schedule. Requires read scope.
get_notification_settings input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}get_notification_settings output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"settings"
],
"properties": {
"settings": {
"type": "object",
"required": [
"timezone",
"quietStart",
"quietEnd",
"onSaleOverride",
"digestTime",
"weeklyDay",
"emailEnabled",
"browserEnabled"
],
"properties": {
"quietEnd": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"timezone": {
"type": "string",
"maxLength": 100
},
"weeklyDay": {
"type": "integer",
"maximum": 6,
"minimum": 0
},
"digestTime": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"quietStart": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"emailEnabled": {
"type": "boolean"
},
"browserEnabled": {
"type": "boolean"
},
"onSaleOverride": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}get_notification_settings annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}update_notification_settings — Update notification settings
Partially update the connected owner's channel toggles, quiet hours or digest schedule. Only supplied fields change; omitted fields retain their current stored values. Requires alerts:write and an entitled owner. Enabling email does not bypass email opt-in/confirmation or browser permission.
update_notification_settings input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"quietEnd": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"timezone": {
"type": "string",
"maxLength": 100
},
"weeklyDay": {
"type": "integer",
"maximum": 6,
"minimum": 0
},
"digestTime": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"quietStart": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"emailEnabled": {
"type": "boolean"
},
"browserEnabled": {
"type": "boolean"
},
"onSaleOverride": {
"type": "boolean"
}
},
"description": "A partial settings patch: provide only fields to change; omitted settings retain their current values.",
"additionalProperties": false
}update_notification_settings output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"settings"
],
"properties": {
"settings": {
"type": "object",
"required": [
"timezone",
"quietStart",
"quietEnd",
"onSaleOverride",
"digestTime",
"weeklyDay",
"emailEnabled",
"browserEnabled"
],
"properties": {
"quietEnd": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"timezone": {
"type": "string",
"maxLength": 100
},
"weeklyDay": {
"type": "integer",
"maximum": 6,
"minimum": 0
},
"digestTime": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"quietStart": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"emailEnabled": {
"type": "boolean"
},
"browserEnabled": {
"type": "boolean"
},
"onSaleOverride": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}update_notification_settings annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}list_agent_tokens — List agent connections
Advertised read-only
List connection IDs, names and scopes for this owner, never token secrets. Requires read scope. Only the human's owner key can create or revoke other connections.
list_agent_tokens input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}list_agent_tokens output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tokens"
],
"properties": {
"tokens": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"scopes"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"type": "string"
},
"scopes": {
"type": "array",
"items": {
"enum": [
"read",
"alerts:write",
"billing",
"planner:write"
],
"type": "string"
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}list_agent_tokens annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}revoke_this_token — Disconnect this agent
Advertised destructive
Immediately and permanently revoke the current agent token. Future calls with it fail; only a human can issue a replacement. Does not cancel billing.
revoke_this_token input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}revoke_this_token output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"revoked"
],
"properties": {
"revoked": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
}revoke_this_token annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}reissue_claim — Reissue the connection link
Only with the agent token start_planner or start_subscription returned, and only until the person first opens a connection link: when they lost it (or it expired), returns a new single-use claimUrl for this token's own owner, valid for 24 hours, and the earlier unused link stops working. Give claimUrl only to that person; opening it saves their planner key in their browser. At most 3 a day. Once any link has been opened it answers 409 already_claimed: the person already has their key, in their saved planner link or through Restore on the planner page. Creates no account and charges nothing.
reissue_claim input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}reissue_claim output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"claimUrl",
"expiresAt"
],
"properties": {
"claimUrl": {
"type": "string",
"format": "uri"
},
"expiresAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
}reissue_claim annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}start_subscription — Connect a new subscriber
Open-world
For a person without an account: create a pending agent connection and a Stripe-hosted Checkout link for the plan (release planner, new-showtime alerts and reminders). $4.99/mo after a 7-day free trial; everything included; the human confirms on Stripe; agents never handle cards. Show the URL to the human; only they can confirm on Stripe. Keep the returned token private. Do not call repeatedly or for an existing subscriber.
start_subscription input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string",
"default": "My AI agent",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": {}
}start_subscription output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"checkoutUrl",
"agentToken",
"status"
],
"properties": {
"status": {
"type": "string",
"const": "pending_payment"
},
"agentToken": {
"type": "string"
},
"checkoutUrl": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}start_subscription annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 633 ms
- 95th percentile latency
- 633 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 633 ms · metadata changed · 34 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http dolby-cinema-tracker-mcp https://dolbycinematracker.xyz/mcpCodex
Codex configuration
codex mcp add dolby-cinema-tracker-mcp --url https://dolbycinematracker.xyz/mcpCursor
Cursor configuration
{
"mcpServers": {
"dolby-cinema-tracker-mcp": {
"url": "https://dolbycinematracker.xyz/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"dolby-cinema-tracker-mcp": {
"type": "streamableHttp",
"url": "https://dolbycinematracker.xyz/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"dolby-cinema-tracker-mcp": {
"type": "http",
"url": "https://dolbycinematracker.xyz/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http dolby-cinema-tracker-mcp https://dolbycinematracker.xyz/mcpClaude Desktop
Claude Desktop configuration
https://dolbycinematracker.xyz/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"dolby-cinema-tracker-mcp": {
"serverUrl": "https://dolbycinematracker.xyz/mcp"
}
}
}Let your agent find its tools
Find servers like Dolby Cinema Tracker MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other productivity and knowledge servers
Do you run Dolby Cinema Tracker MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.