API & MCP for automation
Connect assistants and tools to Workload's IT capacity System of Record — read-only via MCP (scope mcp:read).
Capacity SoR tools (read-only)
POST /api/mcp with a Bearer API key (mcp:read). JSON-RPC 2.0 only: initialize, tools/list, tools/call (params.name + params.arguments). mcp:act stays closed.
curl -X POST https://www.simpleworkload.com/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_capacity_summary","arguments":{}}}'| Tool | Description |
|---|---|
| list_allocations | List organization allocations, optionally filtered by projectId |
| get_capacity_summary | Get aggregated capacity metrics for the organization |
| get_pva_variance | Get planned vs actual variance by project for current fiscal year |
| get_audit_summary | Get recent audit log summary (read-only) |
| get_open_pack | List this week's capacity pack cards (ids, status, variance). Write only via /dashboard/ops after a human vote. |
| get_ops_kpis | Capacity pack KPIs and MCP write checkpoint (informational — does not unlock mcp:act). |
Other read tools
- list_projects — List organization projects
- get_project — Get project by id
- list_team_members — List organization team members
- list_budgets — List organization project budgets
- list_webhooks — List organization webhooks