Skip to content

Public API

Public MCP

The public MCP server gives AI assistants task-shaped tools over the public surface — the same data the public GraphQL API exposes, packaged as callable tools over the Model Context Protocol.

Endpoint/api/mcpTransportStreamable HTTPScopemcp:account

Endpoint

A Streamable-HTTP MCP endpoint. It's also mounted per business at /@<handle>/api/mcp, which pins the tools to that business.

endpoint
https://go.sessions.website/api/mcp

Tools

Discovery tools are open; the two viewer tools act on the signed-in viewer's own data.

Discovery
find_business
Search the directory for a business by name or keyword.
browse_sessions
List a business's upcoming schedule.
get_session
Fetch the full detail of one session.
preview_checkout
Price a session — totals, discounts, and gift cards — without buying.
start_sign_in
Begin the email sign-in flow for a viewer.
Viewer tools · signed-in viewer
my_registrations
List the signed-in viewer's own registrations.
cancel_registration
Cancel one of the viewer's registrations.

Authentication

Discovery tools need no token. Tools that read or change a viewer's own data run as that signed-in viewer.

Discovery — find_business, browse_sessions, get_session, and preview_checkout are anonymous — no token required.

Viewer tools — my_registrations and cancel_registration authenticate with a Bearer JWT or an OAuth access token.

mcp:account
is the scope an MCP client obtains over the OAuth flow to act as a signed-in viewer.

The OAuth handshake — discovery, registration, PKCE, consent — is shared across both MCP servers. OAuth reference

bash
curl https://go.sessions.website/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call",
           "params":{"name":"browse_sessions",
                     "arguments":{"business":"@your-handle"}}}'

Connect a client

Point any MCP client at the endpoint above. The Agents page bundles a ready-to-use connection catalogue and downloadable skills.

Agent toolkitView mcp.json