`cancel_session`

Cancel a scheduled session, with a reason.

Authentication required

Endpoint

endpoint

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

When to use it

To call off a session, with a reason participants will see.
After session_attendance, so you know who it affects before you do it.

Parameters

idstringrequired

Session id to cancel.

reasonExternalstringoptional

Reason shown to registered participants (optional).

reasonInternalstringoptional

Internal-only note (optional).

Returns

Confirmation, or per-field errors. Refunds follow the business’s cancellation policy; a session cancellation bypasses the participant-side cutoff tiers.

Example

POST this to the endpoint above.

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cancel_session",
    "arguments": {
      "id": "<session id>",
      "reasonExternal": "Instructor unwell — sorry!",
      "reasonInternal": "Cover unavailable"
    }
  }
}

content

Session <id> cancelled.

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.

cancel_session

Cancel a session by id. Optionally include a participant-facing reason (reasonExternal) and an internal note (reasonInternal). Refunds follow the business cancellation policy.