Reference
MCP Reference
MCP endpoint over the same scoped Agent Operations contract.
What MCP wraps #
The MCP surface runs over Agent Operations, not a separate authority model. Tools reuse the same scopes, refusal behavior, docs pointers, action intents, and audit semantics.
Tool discovery #
Expose tools in job language so agents can orient quickly.
| Tool family | Expected job |
|---|---|
| Docs and manifest | Find canonical docs, Markdown pages, OpenAPI, and edition identity. |
| Event investigation | Read event history, receipts, lifecycle state, retention, and replay availability. |
| Recovery previews | Preview replay, diagnostics share, or other governed action intents. |
Refusals #
MCP tools return clear refusal reasons when the grant, product boundary, retention state, usage limit, or safety rule blocks an action. Tool responses include the relevant docs URL when useful.
Troubleshooting #
When a tool cannot act, the agent reads the linked docs page, checks /agent/v1/manifest, inspects OpenAPI, then escalates to a human if the action remains outside authority.
FlowRelay