Tool reference

get_schedule_capacity

Get Schedule Capacity. Check how many more notes the user is allowed to schedule on their current plan.

GroupAccessMCP name
ScheduleRead-onlyget_schedule_capacity

Description

The description the MCP server sends to the model, word for word. Its rules apply to every call.

Check how many more notes the user is allowed to schedule on their current plan. Returns maxScheduledNotes (the plan limit), currentScheduledCount, remaining (how many more they may schedule right now), and unlimited (true = the user has the Unlimited Schedules addon and there is no limit). ALWAYS call this before schedule_notes or schedule_notes_with_custom_dates, and NEVER schedule more notes than remaining unless unlimited is true.

Arguments

This tool takes no arguments.

Example call

The smallest valid request: required arguments only, with placeholder values.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_schedule_capacity",
    "arguments": {}
  }
}

Result

The result has structuredContent that matches this schema. The same data is also in content as JSON text.

FieldTypeRequiredDescription
currentScheduledCountnumberYes
maxScheduledNotesnumberYes
messagestringYes
remainingnumberYes
unlimitedbooleanYes

Annotations

HintValue
readOnlyHinttrue
destructiveHintfalse
openWorldHintfalse

The full input and output JSON Schemas for every tool are in /mcp-tools.json.

On this page