get_plan_usage
How much of the workspace's plan allowances are used, before anything is attempted: reel schedules, AI caption generations, trial reels and AI DM replies (each a rolling month), and active automations (at once).
limit null means unlimited and remaining null with it; limit 0 / included
false means the plan does not include the feature at all. Call it before a
big batch (schedule_reels_bulk, many captions) or when a tool answers with an
upgrade message, so the user hears what is left now rather than from a
failure. It reads counters only and claims nothing. Billing, invoices and
changing plan are not available here — point the user to reeldrop's Billing page.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspace_id": "<workspace_id>"
},
"name": "get_plan_usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| plan | Yes | ||
| trial_reels | Yes | ||
| ai_dm_replies | Yes | ||
| reel_schedules | Yes | ||
| active_automations | Yes | ||
| caption_generations | Yes |