Permissions & approvals

Allow, ask or block each tool; approve calls at runtime; admin floors that members cannot loosen.

Last updated 2026-11-14

Levels

Every tool has one of three levels, as in Claude and Codex:

LevelEffect
AllowThe call runs without asking.
AskThe execution pauses until you approve the call.
BlockThe call is refused, and the tool is hidden from search.

Defaults

SourceAnnotationDefault
DirectoryreadOnlyHint: trueAllow
Directorywrite or destructiveHintAsk
Free URLanyProposed, you confirm on first setup
AnynoneTreated as a write: Ask

The bridge checks the level on every call, not only during discovery. When a tool’s signature changes, an approved level goes back to to confirm and the tool behaves as Ask.

Admin floors

In company workspaces, admins set a minimum level for the whole workspace or per tool. Members can make permissions stricter, never looser. The effective level is the most restrictive of the defaults, the workspace floor, the per-tool floor and the member’s own choice.

Runtime approvals

  • With elicitation (your client supports it): a dialog shows the connector, the tool, the main arguments and the workspace, with approve this call, approve every call to this tool in this script, or reject.
  • Without elicitation: execute returns a link to the Toolkien approval page and a waiting status; after you decide, the agent calls execution_status to resume.

Approvals come only from a signed-in human: there is no MCP tool that approves, and nothing the model sends counts as an approval. Owners and admins of a company workspace can also decide a member’s pending approval; the log records who approved (the user, an admin, or the policy). Pending approvals expire after 30 minutes.