Skip to content

browse_sessions

List a business's upcoming schedule.

Anonymous, or a Bearer token for viewer tools

Endpoint

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

When to use it

  • The usual entry point once you know the handle.

  • To get the session ids that get_session and preview_checkout take.

Parameters

handlestringoptional

Business handle (the @slug). Optional if pinned.

limitnumberoptional

Max sessions (default 20).

Returns

The business's upcoming sessions with time, status, price, and registration and waitlist counts.

Example

POST this to the endpoint above.

JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "browse_sessions",
    "arguments": {
      "handle": "capital-bodywork",
      "limit": 10
    }
  }
}
content
Capital Bodywork (@capital-bodywork) — 23
scheduled session(s):
- Morning Yoga [<id>] · 2026-09-02T09:00 →
  2026-09-02T10:00 · scheduled · $24.00 · 8 registered

What the agent is told

The description the model reads when deciding whether to call this. It is the only thing that decides whether the tool fires at the right moment, so it is worth knowing what it says.

browse_sessions
List a business's upcoming scheduled sessions (name, time, status, price, registration counts). Pass the business handle, or omit it when the connection is already pinned to a business.

See also