Agentorist

Working · 1.8 s

com.agentorist/agentoristv1.0.0 Domain verified

Booking gateway for AI agents — discover events, movies & hotels, hand off to partner checkout.

Maps & Travel Entertainment & Games

Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.agentorist.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

book Destructive

Book an option (showtime, ticket class, etc.). If a partner API is connected, completes the booking inline with a confirmation code. Otherwise returns an affiliate deep link the agent should hand to the user.

verticalstring, required

The vertical (e.g. "movies", "events").

option_idstring, required

showtime_id or ticket_id from find_options.

locationstring

For affiliate fallback.

item_titlestring

For affiliate fallback / logging.

party_sizeinteger

Number of tickets/seats. Default 2.

venue_namestring

For logging.

agent_clientstring

Optional — name of the calling agent (Claude, ChatGPT, etc.).

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (7)

book

destructive

Argument	Type	Description
location	string	For affiliate fallback.
vertical*	string	The vertical (e.g. "movies", "events").
option_id*	string	showtime_id or ticket_id from find_options.
item_title	string	For affiliate fallback / logging.
party_size	integer	Number of tickets/seats. Default 2.
venue_name	string	For logging.
agent_client	string	Optional — name of the calling agent (Claude, ChatGPT, etc.).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "vertical",
    "option_id"
  ],
  "properties": {
    "location": {
      "type": "string",
      "default": "",
      "description": "For affiliate fallback."
    },
    "vertical": {
      "type": "string",
      "description": "The vertical (e.g. \"movies\", \"events\")."
    },
    "option_id": {
      "type": "string",
      "description": "showtime_id or ticket_id from find_options."
    },
    "item_title": {
      "type": "string",
      "default": "",
      "description": "For affiliate fallback / logging."
    },
    "party_size": {
      "type": "integer",
      "default": 2,
      "description": "Number of tickets/seats. Default 2."
    },
    "venue_name": {
      "type": "string",
      "default": "",
      "description": "For logging."
    },
    "agent_client": {
      "type": "string",
      "default": "",
      "description": "Optional — name of the calling agent (Claude, ChatGPT, etc.)."
    }
  },
  "additionalProperties": false
}

find_options

Find concrete bookable options for an item. For movies: showtimes for the given film. For events: ticket classes.

read-only

Argument	Type	Description
when	string	ISO date (YYYY-MM-DD) or "today"/"tomorrow". Default "today".
item_id*	string	ID returned by `search` (film_id, event_id), or a title for fuzzy lookup.
location	string	City, postcode, or "lat,lng" — required for movies.
vertical*	string	The vertical (e.g. "movies", "events").
agent_client	string	Optional — name of the calling agent (Claude, ChatGPT, etc.). Pass the SAME value across search → find_options → book so the trust stack can link the booking to its prior discovery.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "vertical",
    "item_id"
  ],
  "properties": {
    "when": {
      "type": "string",
      "default": "today",
      "description": "ISO date (YYYY-MM-DD) or \"today\"/\"tomorrow\". Default \"today\"."
    },
    "item_id": {
      "type": "string",
      "description": "ID returned by `search` (film_id, event_id), or a title for fuzzy lookup."
    },
    "location": {
      "type": "string",
      "default": "",
      "description": "City, postcode, or \"lat,lng\" — required for movies."
    },
    "vertical": {
      "type": "string",
      "description": "The vertical (e.g. \"movies\", \"events\")."
    },
    "agent_client": {
      "type": "string",
      "default": "",
      "description": "Optional — name of the calling agent (Claude, ChatGPT,\netc.). Pass the SAME value across search → find_options → book so\nthe trust stack can link the booking to its prior discovery."
    }
  },
  "additionalProperties": false
}

list_venues

List venues near a location, marked as bookable or not.

read-only

Argument	Type	Description
location*	string	City, postcode, or "lat,lng".
vertical*	string	The vertical (e.g. "movies", "events").
radius_km	number	Search radius. Default 15 km.
agent_client	string	Optional — name of the calling agent (Claude, ChatGPT, etc.).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "vertical",
    "location"
  ],
  "properties": {
    "location": {
      "type": "string",
      "description": "City, postcode, or \"lat,lng\"."
    },
    "vertical": {
      "type": "string",
      "description": "The vertical (e.g. \"movies\", \"events\")."
    },
    "radius_km": {
      "type": "number",
      "default": 15,
      "description": "Search radius. Default 15 km."
    },
    "agent_client": {
      "type": "string",
      "default": "",
      "description": "Optional — name of the calling agent (Claude, ChatGPT, etc.)."
    }
  },
  "additionalProperties": false
}

list_verticals

List all booking verticals Agentorist currently supports. Returns a dict with each vertical's name and description. Call this first to discover what's bookable before constructing other tool calls.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

request_unsupported_booking

Log a booking request Agentorist can't yet fulfil. This is the demand-intelligence engine. Every call here becomes a data point sold to the venue as monthly missed-revenue insight. Optionally captures email so the user is notified when the venue joins.

destructive

Argument	Type	Description
location	string	City or area.
vertical*	string	Which vertical the request belongs to.
when_iso	string	Requested time in ISO 8601 (optional).
item_title*	string	The film, event, or experience.
party_size	integer	Number of tickets.
user_email	string	Optional, for join-notification.
venue_name*	string	Name of the venue the user wanted.
venue_chain	string	e.g. Vue, Odeon, Cineworld.
agent_client

Search for bookable items within a vertical.

read-only

Argument	Type	Description
when	string	Optional ISO date filter (YYYY-MM-DD) for events.
query*	string	Natural-language query — movie title, event keyword, tour name, theme like "beach getaway", etc.
rooms	integer
adults	integer
locale	string	Optional BCP-47 locale ('en-US', 'fr-FR', 'de-DE', 'ja-JP', etc.). Currently consumed by the 'experiences' vertical to localise the Viator response and hand-off URL. Auto-detected from the query when the language is unambiguous.
check_in	string
children	integer
location*	string	City, postcode, or "lat,lng".
vertical*	string	One of the names returned by list_verticals (e.g. "movies", "events", "experiences", "hotels", "cars").

search_all

Search every Agentorist vertical at once — the answer to "what's on?". Use this when the user's request spans verticals or doesn't clearly name one ("what's on tonight", "anything to do in Boston?", "Friday night plans"). For specific single-vertical queries ("movies tonight", "Italian restaurants"), `search_all` auto-narrows to the hinted vertical so you don't waste calls. Returns `results_by_vertical` keyed by movies/events/local, plus `total_count` and `bookable_total` for quick summaries.

read-only

Argument	Type	Description
when	string	Optional time hint ("tonight", "weekend", or ISO date).
query*	string	Natural-language query. Empty string is fine (= browse).
locale	string	Optional BCP-47 locale ('en-US', 'fr-FR', 'de-DE', etc.). Forwarded to verticals that localise their response (experiences).
location*	string	City, postcode, or "lat,lng".
territory	string	ISO country code (US, GB, etc.). Default US.
agent_client	string	Optional — name of the calling agent.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query",
    "location"
  ],
  "properties": {
    "when": {
      "type": "string",
      "default": "",
      "description": "Optional time hint (\"tonight\", \"weekend\", or ISO date)."
    },
    "query": {
      "type": "string",
      "description": "Natural-language query. Empty string is fine (= browse)."
    },
    "locale": {
      "type": "string",
      "default": "",
      "description": "Optional BCP-47 locale ('en-US', 'fr-FR', 'de-DE', etc.).\nForwarded to verticals that localise their response (experiences)."
    },
    "location": {
      "type": "string",
      "description": "City, postcode, or \"lat,lng\"."
    },
    "territory": {
      "type": "string",
      "default": "US",
      "description": "ISO country code (US, GB, etc.). Default US."
    },
    "agent_client": {
      "type": "string",
      "default": "",
      "description": "Optional — name of the calling agent."
    }
  },
  "additionalProperties": false
}

{ "type": "object", "required": [ "vertical", "query", "location" ], "properties": { "when": { "type": "string", "default": "", "description": "Optional ISO date filter (YYYY-MM-DD) for events." }, "query": { "type": "string", "description": "Natural-language query — movie title, event keyword, tour name,\ntheme like \"beach getaway\", etc." }, "rooms": { "type": "integer", "default": 1 }, "adults": { "type": "integer", "default": 0 }, "locale": { "type": "string", "default": "", "description": "Optional BCP-47 locale ('en-US', 'fr-FR', 'de-DE', 'ja-JP', etc.).\nCurrently consumed by the 'experiences' vertical to localise the\nViator response and hand-off URL. Auto-detected from the query\nwhen the language is unambiguous." }, "check_in": { "type": "string", "default": "" }, "children": { "type": "integer", "default": 0 }, "location": { "type": "string", "description": "City, postcode, or \"lat,lng\"." }, "vertical": { "type": "string", "description": "One of the names returned by list_verticals (e.g. \"movies\",\n\"events\", \"experiences\", \"hotels\", \"cars\")." }, "check_out": { "type": "string", "default": "" }, "territory": { "type": "string", "default": "US", "description": "ISO country code (US, GB, etc.). Default US." }, "driver_age": { "type": "integer", "default": 0 }, "hotel_name": { "type": "string", "default": "" }, "hotel_class": { "type": "string", "default": "" }, "pickup_date": { "type": "string", "default": "" }, "agent_client": { "type": "string", "default": "", "description": "Optional — name of the calling agent (Claude, ChatGPT, etc.)." }, "budget_range": { "type": "string", "default": "" }, "dropoff_date": { "type": "string", "default": "" } }, "additionalProperties": false }