start_planner
Start a release planner
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. 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.
输入参数name
list_releases
List releases to plan
Upcoming catalog releases with your saved tier and suggest-v1 suggestion. Suggestions are advice, never intent. Use the returned filmId with set_tier.
无需输入参数。
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.
输入参数theatreIds必填
list_reminders
List your reminders
List only your reminders and their configured delivery source. Requires alerts:write.
无需输入参数。
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.
输入参数atkind必填eventmovieIdticketIdminutesBeforedeliverySubscriptionId必填
delete_reminder
Delete your reminder
Delete only your reminder and expire any still-pending delivery. Does not alter tickets or follows.
输入参数id必填
get_plan
Get your movie plan
Read your private plan, protected booked tickets, requests and as-planned capacity. Never creates booking intent.
无需输入参数。
get_capacity
Get as-planned capacity
Read planner capacity, not live AMC eligibility. Available to every planner owner.
无需输入参数。
get_best_showings
Rank showings for your plan
Rank existing showings at the owner's home theatres with the same planner eligibility, protected ticket conflicts and format preferences. Returns the whole ranking (at most 600, flagged truncated), never paged. Does not queue or book.
输入参数tofromfilmId必填
set_tier
Set a movie's planner tier
Set top, want, maybe, skip, seen or declined using existing rules. Top protects booked tickets; lowering a tier never removes protection. Does not create a booking request.
输入参数tier必填notesfilmId必填
set_format_preference
Set planner format preference
Set default format order and explicit 3D permission. Never books or modifies protected tickets.
输入参数allow3d必填formatOrder必填
request_booking
Explicitly request a booking
Private executor accounts only. Only call when the human explicitly asks to queue a booking. Supply 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.
输入参数filmId必填clientKey必填flexibilityselectedShowtimeId
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.
输入参数id必填revision必填
search_showtimes
Search AMC showtimes
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.
输入参数zippagemoviedateToformatradiustheatredateFrompageSize
list_drops
List new ticket drops
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.
输入参数zipkindpagemoviesince必填dateToformatradiustheatredateFrompageSize
get_movie
Get movie details
Get the collected movie record by movie ID or slug. Use search_showtimes for its showings.
输入参数movie必填
find_theatres
Find AMC theatres
Find active collected AMC theatres by name/city, ZIP and radius in miles. Theatre capabilities do not establish an individual showing's format.
输入参数zipqueryradius
find_double_features
Find double features
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.
输入参数date必填movieformatmaxGapminGaptheatre必填
get_pricing
Get subscription pricing
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_subscription_status
Get subscription status
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.
无需输入参数。
create_checkout_link
Create Stripe Checkout link
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_billing_portal_link
Create billing portal link
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.
无需输入参数。
list_alerts
List your alerts
List only the connected owner's saved follows and their current status. Requires read scope.
无需输入参数。
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.
输入参数emailmovie必填browsercadenceformatstheatrestimezonetriggersemailConsent
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.
输入参数id必填emailbrowsercadenceformatstheatrestimezonetriggersemailConsent
pause_alert
Pause an alert
Pause only the connected owner's alert. Requires alerts:write and a paid plan.
输入参数id必填
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.
输入参数id必填
delete_alert
Delete an alert
Permanently delete only the connected owner's alert. This does not cancel the subscription. Requires alerts:write and a paid plan.
输入参数id必填
get_notification_settings
Get notification settings
Read the connected owner's email/push preferences, timezone, quiet hours and digest schedule. Requires read scope.
无需输入参数。
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.
输入参数quietEndtimezoneweeklyDaydigestTimequietStartemailEnabledbrowserEnabledonSaleOverride
list_agent_tokens
List agent connections
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.
无需输入参数。
revoke_this_token
Disconnect this agent
Immediately and permanently revoke the current agent token. Future calls with it fail; only a human can issue a replacement. Does not cancel billing.
无需输入参数。
start_subscription
Connect a new subscriber
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.
输入参数name