Developer documentation

Connect your agent
in minutes.

Agentorist is a Model Context Protocol (MCP) server. Any MCP-compatible client can connect and immediately give its users the ability to discover, route, and book — without leaving the conversation.

Quick start

Add Agentorist to your MCP client config. No API key, no token, no authentication — connect and go.

Server URL — works with any MCP-compatible client (Claude Desktop, Cursor, Cline, Gemini CLI, and others):

https://mcp.agentorist.com/mcp
Transport: streamable-http

Setting up a specific client? Step-by-step instructions for Grok, Claude Desktop, ChatGPT, Cursor and any other MCP client are on the Connect page.

Available tools

Connecting to Agentorist gives your agent seven tools:

list_verticals

Returns the booking categories Agentorist supports (experiences, events, hotels, etc.) and their current availability status.

Search for bookable items within a specific vertical — e.g. concerts in Boston this weekend, or hotels in Lisbon for two nights.

search_all

Cross-vertical search. Returns results across all supported categories for a given query and location.

find_options

Given a specific item (a show, venue, or listing), returns available booking options — ticket classes, showtimes, seat types, pricing.

book

Initiates the booking and returns a ready-to-complete hand-off to the partner's own checkout (e.g. Ticketmaster), with the item already selected. The user completes payment on the partner's site. No authentication required.

list_venues

Lists venues in a given area and vertical. Useful for discovery before a user has a specific item in mind.

request_unsupported_booking

When a booking can't be completed inline, returns the best available deep link to the partner's own checkout — pre-filled where possible.

Authentication

None. Every tool — search, discovery and booking — works without an API key, token or OAuth flow. Connect the server and your agent can use it immediately.

The book tool never takes payment or holds credentials. It returns a hand-off to the partner's own checkout (e.g. Ticketmaster), where the user completes the purchase under that partner's account and security. Agentorist never sees card or login details.

Discovery manifest

The machine-readable server card is available at /.well-known/mcp.json. It describes the server, its transport and capabilities in the MCP 2026-01 server card format.

View mcp.json

Support