Beta module namespace
capabilities
Beta routes may change with notice and are NOT covered by the 24-month stable window of the core contract.
Every module route is enumerated with method, path, auth and required permission; request/response schemas are not published for the beta surface.
14 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/capabilities/configs | capabilities:config:read | Bearer token | Lists managed MCP-server configs, optionally filtered. |
| post | /v1/m/capabilities/configs | capabilities:config:write | Bearer token | Registers a new managed config for an MCP server, recording the first revision snapshot and a self-audit attributed to the real principal. |
| get | /v1/m/capabilities/configs/{id} | capabilities:config:read | Bearer token | Returns one managed config. |
| put | /v1/m/capabilities/configs/{id} | capabilities:config:write | Bearer token | Updates a managed config in place, bumping its revision and recording an immutable revision snapshot plus a self-audit. |
| delete | /v1/m/capabilities/configs/{id} | capabilities:config:write | Bearer token | Removes a managed config, recording a final revision snapshot (the immutable history survives the deletion) and a self-audit. |
| get | /v1/m/capabilities/configs/{id}/revisions | capabilities:config:read | Bearer token | Returns the immutable version history of a config, newest revision first. |
| get | /v1/m/capabilities/servers | capabilities:catalog:read | Bearer token | Lists the live MCP-server catalog: every discovered MCPServer core entity enriched with its derived connection health, managed-config marker and tool count. |
| get | /v1/m/capabilities/servers/{id} | capabilities:catalog:read | Bearer token | Returns the full management view of one MCP server. |
| get | /v1/m/capabilities/skills | capabilities:catalog:read | Bearer token | Lists the discovered skills (and the surface through which plugins/subagents appear), optionally filtered by ?server_id. |
| get | /v1/m/capabilities/toolpins | capabilities:config:read | Bearer token | capabilities module route (requires capabilities:config:read) |
| post | /v1/m/capabilities/toolpins/approve | capabilities:config:write | Bearer token | capabilities module route (requires capabilities:config:write) |
| post | /v1/m/capabilities/toolpins/unpin | capabilities:config:write | Bearer token | capabilities module route (requires capabilities:config:write) |
| get | /v1/m/capabilities/tools | capabilities:catalog:read | Bearer token | Lists the discovered tools with their UNTRUSTED annotation hints, optionally filtered by ?server_id. |
| get | /v1/m/capabilities/wiring | capabilities:catalog:read | Bearer token | Returns the capability-connection graph, optionally filtered by origin or capability. |