Tools and approvals¶
Every tool an agent can call has a class, and every session has a tool mode. Together they decide which tools the model is offered and which ones ask the user first.
Where tools run¶
| Kind | Runs | Declared by |
|---|---|---|
| Host tools | In your application, on the user's device: they read or change the open document, page or program | Your code, with the SDK |
| Local MCP servers | On the user's device, as separate processes the agent starts (.NET SDK) | Your code; the server's policy for the agent decides whether they may start |
| Server tools | On the Fadenstack server: the MCP servers IT has registered | IT, in the console |
The model sees one list of tools. Host tools run in your code, server tools run on the server, and the SDK hands each call to the right place.
Tool classes¶
Every tool has one of four classes. The class says what the tool may do.
| Class | Means |
|---|---|
| Read | Reads and changes nothing |
| Write | Changes something that can be changed back |
| Destructive | Changes something that cannot easily be changed back, or sends something away |
| Unknown | Nobody said. Treated like the strictest class. Tools from local MCP servers are always Unknown, because an MCP server's own description of its tools is not trusted. |
Tool modes¶
The user picks a mode for each session. Every session starts in Ask.
| Mode | Read | Write | Destructive | Unknown |
|---|---|---|---|---|
| Off | hidden | hidden | hidden | hidden |
| Read only | runs | hidden | hidden | hidden |
| Ask | runs | asks | asks | asks |
| Auto | runs | runs | asks | asks |
- hidden: the tool is not offered to the model, and refused if the model calls it anyway.
- asks: the SDK calls your approval handler before the tool runs. Without a handler, the answer is no.
- Approve for this session stops asking for that one tool until the session ends.
The SDK sends the session's mode with each request, and the server applies the same table to its own tools.
Classes are ToolClass.Read, Write, Destructive and Unknown; modes are ToolMode.Off, ReadOnly, Ask and Auto. See Host tools.
Classes are "read", "write", "destructive" and "unknown"; modes are "off", "read_only", "ask" and "auto". See Tools.
Bypass: no questions for one conversation¶
Above Auto there is a fifth level, Bypass. A person switches it on for one conversation and for a time they pick; the server holds it as a grant of kind bypass. While it runs, calls that would ask run without asking, destructive and unclassified ones too. What still asks: an administrator's "Ask first" rule, a tool the agent's contract marks always ask, and whatever the tool mode hides. The server records every call it lets through.
- A second sign-in. After the person's confirmation, they sign in again in the browser. Only then does the server grant Bypass. The sign-in is good for every Bypass on that agent and device for five minutes.
- Only where allowed. The organisation must allow Bypass, the agent's version must go up to it, and no limit may be lower. No conversation starts in Bypass.
- It ends at the end of the time, when the person picks another mode, or when an administrator or the organisation switches it off. More time is a new Bypass.
Grants: for a time, and for a stretch of work¶
Besides Bypass the server holds two smaller grants. Both come from an approval card, and both are limited to the agent's longest grant (two hours unless the agent's author set less):
- For a time: the person lets one read or write tool run without asking for a while ("Allow for 30 minutes").
- For a stretch of work: the person lets read and write calls run in the places they name, such as a document or a site, for a while.
A grant never covers a destructive or unclassified call, a tool the contract marks always ask, or a call an administrator's rule asks about. A grant for a whole plan is not offered yet.
The card, the lifecycle and the code are in the SDK pages: .NET (grants), TypeScript. The routes are the gateway's /v1/agents/{agent}/grants; the SDKs call them for you.
What the server adds¶
- The agent's contract. An administrator can list, for each agent, the host tools it may offer and their classes. The contract can make a tool's class stricter, never looser. When the contract is not empty, tools outside it are not offered. See Agents on the server.
- New tools wait. When a new version of your application brings a tool the agent's published version does not know, the server holds it back until an administrator accepts it.
- Tool rules. Administrators can deny a tool, require approval for it, or allow it, for host tools and server tools alike.
- Mode limits Planned. In the Enterprise edition an administrator will be able to narrow the modes a user may pick for an agent.