list_capabilities
List capabilities with per-actor availability, scopes, confirmation policy, and bounded hints.
# MCP tool reference
1 callable tools.
Use tools/call at https://mcp.schedulerzero.com/mcp with the exact tool name and arguments below. The /tools/ paths in this view are documentation identifiers, not HTTP endpoints. Request execution is disabled for this reference.
Inputs are shown for personal API keys (bound) and for OAuth/delegated agents. Output schemas describe MCP structuredContent: native objects pass through; arrays, scalars and null use a data wrapper. Text content retains the native JSON result.
[Connect a client](/mcp/connect) · [Authentication and authorization](/authentication) · [Generated auth guide](/auth.md) · [Download tool catalog](/mcp-catalog.json) · [Agent documentation](/llms.txt)
## list_capabilities
List capabilities with per-actor availability, scopes, confirmation policy, and bounded hints.
Use to discover what this credential can actually run right now, filtered by feature, risk, or availability.
Availability is computed per request; do not cache it across credential or consent changes.
Scopes: agent:capabilities
Risk: read; confirmation: none; idempotency: none.
### Input schema (personal API key)
```json
{
"type": "object",
"properties": {
"cursor": {
"$ref": "#/$defs/Cursor"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"feature": {
"$ref": "#/$defs/NonEmptyString"
},
"risk": {
"type": "string",
"enum": [
"read",
"write",
"costly",
"destructive",
"security_admin"
]
},
"availability": {
"type": "string",
"enum": [
"available",
"scope_required",
"permission_denied",
"feature_disabled",
"subscription_blocked",
"human_completion_required",
"temporarily_unavailable"
]
}
},
"patternProperties": {
"^(?!(?:cursor|limit|feature|risk|availability)$)[\\s\\S]*$": false
},
"additionalProperties": true,
"propertyNames": {
"type": "string",
"enum": [
"cursor",
"limit",
"feature",
"risk",
"availability"
]
},
"$defs": {
"Cursor": {
"type": "string",
"minLength": 1,
"maxLength": 2048
},
"NonEmptyString": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
}
}
```
### Input schema (OAuth / delegated agent)
```json
{
"type": "object",
"properties": {
"cursor": {
"$ref": "#/$defs/Cursor"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"feature": {
"$ref": "#/$defs/NonEmptyString"
},
"risk": {
"type": "string",
"enum": [
"read",
"write",
"costly",
"destructive",
"security_admin"
]
},
"availability": {
"type": "string",
"enum": [
"available",
"scope_required",
"permission_denied",
"feature_disabled",
"subscription_blocked",
"human_completion_required",
"temporarily_unavailable"
]
}
},
"patternProperties": {
"^(?!(?:cursor|limit|feature|risk|availability)$)[\\s\\S]*$": false
},
"additionalProperties": true,
"propertyNames": {
"type": "string",
"enum": [
"cursor",
"limit",
"feature",
"risk",
"availability"
]
},
"$defs": {
"Cursor": {
"type": "string",
"minLength": 1,
"maxLength": 2048
},
"NonEmptyString": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
}
}
```
### Output schema (structuredContent)
```json
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,63}$"
},
"feature": {
"$ref": "#/$defs/NonEmptyString"
},
"purpose": {
"$ref": "#/$defs/Description"
},
"prerequisites": {
"type": "array",
"items": {
"$ref": "#/$defs/ShortText"
}
},
"kind": {
"type": "string",
"enum": [
"direct_tool",
"mcp_resource",
"async_operation",
"preview_commit",
"user_completion",
"human_only"
]
},
"risk": {
"type": "string",
"enum": [
"read",
"write",
"costly",
"destructive",
"security_admin"
]
},
"scopes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"agent:capabilities",
"agent:identity",
"agent:operations:cancel",
"agent:operations:read",
"analytics:export",
"analytics:read",
"apiKey:create",
"apiKey:delete",
"apiKey:read",
"apiKey:update",
"audit:read",
"billing:manage",
"billing:read",
"blocklist:create",
"blocklist:delete",
"blocklist:read",
"campaign:archive",
"campaign:create",
"campaign:delete",
"campaign:launch",
"campaign:pause",
"campaign:read",
"campaign:update",
"dialer:assign_numbers",
"dialer:assign_seats",
"dialer:create",
"dialer:delete",
"dialer:dial",
"dialer:manage_billing",
"dialer:manage_number_health",
"dialer:manage_numbers",
"dialer:manage_numbers_self",
"dialer:manage_voicemails",
"dialer:read",
"dialer:read_analytics",
"dialer:read_numbers_all",
"dialer:release_numbers",
"dialer:update",
"domain:manage_dns",
"domain:purchase",
"domain:read",
"domain:transfer",
"emailVerification:manage_credits",
"emailVerification:manage_keys",
"emailVerification:manage_sharing",
"emailVerification:read",
"emailVerification:verify",
"inbox:connect",
"inbox:create",
"inbox:delete",
"inbox:read",
"inbox:update",
"inbox:warmup_manage",
"integration:create",
"integration:delete",
"integration:read",
"integration:update",
"lead:create",
"lead:delete",
"lead:export",
"lead:import",
"lead:read",
"lead:update",
"leadList:create",
"leadList:delete",
"leadList:read",
"leadList:update",
"org:delete",
"orgAnalytics:read",
"orgAnalytics:manage",
"org:read",
"org:update",
"orgApiKey:manage",
"orgMember:invite",
"orgMember:read",
"orgMember:remove",
"orgMember:update",
"phoneVerification:manage_keys",
"phoneVerification:read",
"phoneVerification:verify",
"platform:operate",
"replyLabel:create",
"replyLabel:delete",
"replyLabel:read",
"replyLabel:update",
"role:manage",
"role:read",
"sequence:create",
"sequence:delete",
"sequence:read",
"sequence:update",
"sql:manage_dashboards",
"sql:query",
"support:create",
"support:read",
"support:update",
"tag:create",
"tag:delete",
"tag:read",
"tag:update",
"task:create",
"task:delete",
"task:read",
"task:update",
"template:create",
"template:delete",
"template:read",
"template:update",
"unibox:archive",
"unibox:label",
"unibox:read",
"unibox:reply",
"usage:read",
"webhook:create",
"webhook:delete",
"webhook:read",
"webhook:update",
"whiteLabel:read",
"whiteLabel:update",
"workflow:create",
"workflow:delete",
"workflow:publish",
"workflow:read",
"workflow:run",
"workflow:update",
"workspace:create",
"workspace:delete",
"workspace:read",
"workspace:transfer",
"workspace:update",
"workspaceMember:invite",
"workspaceMember:read",
"workspaceMember:remove",
"workspaceMember:update"
]
}
},
"confirmation": {
"type": "string",
"enum": [
"none",
"explicit",
"preview_token",
"human_completion"
]
},
"resultMode": {
"type": "string",
"enum": [
"inline",
"page",
"operation_handle",
"stream",
"download",
"redirect"
]
},
"availability": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"available",
"scope_required",
"permission_denied",
"feature_disabled",
"subscription_blocked",
"human_completion_required",
"temporarily_unavailable"
]
},
"reason": {
"$ref": "#/$defs/ShortText"
}
},
"required": [
"state"
],
"patternProperties": {
"^(?!(?:state|reason)$)[\\s\\S]*$": false
},
"additionalProperties": true,
"propertyNames": {
"type": "string",
"enum": [
"state",
"reason"
]
}
},
"inputFields": {
"type": "array",
"items": {
"$ref": "#/$defs/NonEmptyString"
}
},
"outputBounds": {
"type": "object",
"properties": {
"maxItems": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"maxBytes": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"maxItems",
"maxBytes"
],
"patternProperties": {
"^(?!(?:maxItems|maxBytes)$)[\\s\\S]*$": false
},
"additionalProperties": true,
"propertyNames": {
"type": "string",
"enum": [
"maxItems",
"maxBytes"
]
}
},
"bundles": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,63}$"
}
}
},
"required": [
"id",
"feature",
"purpose",
"prerequisites",
"kind",
"risk",
"scopes",
"confirmation",
"resultMode",
"availability",
"inputFields",
"outputBounds",
"bundles"
],
"patternProperties": {
"^(?!(?:id|feature|purpose|prerequisites|kind|risk|scopes|confirmation|resultMode|availability|inputFields|outputBounds|bundles)$)[\\s\\S]*$": false
},
"additionalProperties": true,
"propertyNames": {
"type": "string",
"enum": [
"id",
"feature",
"purpose",
"prerequisites",
"kind",
"risk",
"scopes",
"confirmation",
"resultMode",
"availability",
"inputFields",
"outputBounds",
"bundles"
]
}
}
},
"nextCursor": {
"anyOf": [
{
"$ref": "#/$defs/Cursor"
},
{
"type": "null"
}
]
}
},
"required": [
"items",
"nextCursor"
],
"patternProperties": {
"^(?!(?:items|nextCursor)$)[\\s\\S]*$": false
},
"additionalProperties": true,
"propertyNames": {
"type": "string",
"enum": [
"items",
"nextCursor"
]
},
"$defs": {
"NonEmptyString": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"Description": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"ShortText": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"Cursor": {
"type": "string",
"minLength": 1,
"maxLength": 2048
}
}
}
```
### Underlying API operations
- `agent.listCapabilities`: `GET /agent/capabilities`