com.agentorist/agentorist

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "agentorist": {
      "url": "https://mcp.agentorist.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (7)

• list_verticals read-only

  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.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• search read-only

  Search for bookable items within a vertical.

  Parameters:

  • vertical (required) — string — One of the names returned by list_verticals (e.g. "movies", "events", "experiences", "hotels", "cars").
  • query (required) — string — Natural-language query — movie title, event keyword, tour name, theme like "beach getaway", etc.
  • location (required) — string — City, postcode, or "lat,lng".
  • when — string — Optional ISO date filter (YYYY-MM-DD) for events.
  • 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
  • check_out — string
  • territory — string — ISO country code (US, GB, etc.). Default US.
  • driver_age — integer
  • hotel_name — string
  • hotel_class — string
  • pickup_date — string
  • agent_client — string — Optional — name of the calling agent (Claude, ChatGPT, etc.).
  • budget_range — string
  • dropoff_date — string

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• search_all read-only

  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.

  Parameters:

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

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• find_options read-only

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

  Parameters:

  • vertical (required) — string — The vertical (e.g. "movies", "events").
  • item_id (required) — string — ID returned by `search` (film_id, event_id), or a title for fuzzy lookup.
  • when — string — ISO date (YYYY-MM-DD) or "today"/"tomorrow". Default "today".
  • location — string — City, postcode, or "lat,lng" — required for movies.
  • 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.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • vertical (required) — string — The vertical (e.g. "movies", "events").
  • option_id (required) — string — showtime_id or ticket_id from find_options.
  • location — string — For affiliate fallback.
  • 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.).

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

• list_venues read-only

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

  Parameters:

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

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• request_unsupported_booking destructive

  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.

  Parameters:

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

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.