Skip to content

upcoming_sessions

List the business's upcoming schedule.

Authentication required

Endpoint

endpoint
https://business.sessions.website/@<handle>/api/mcp

When to use it

  • To answer "what is on this week" for staff.

  • To get the session id session_attendance and cancel_session take.

Parameters

limitnumberoptional

Max sessions (default 25).

Returns

Upcoming sessions with time, status, and registration, waitlist and pending-request counts.

Example

POST this to the endpoint above.

JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "upcoming_sessions",
    "arguments": {
      "limit": 20
    }
  }
}
content
12 upcoming session(s):
- Morning Yoga [<id>] · 2026-09-02T09:00 ·
  scheduled · 8 registered, 1 waitlisted

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.

upcoming_sessions
List the business's upcoming scheduled sessions with time, status, and registration / waitlist / pending-request counts.

See also