Securing agent tool use.

A tool catalog is not an authority model. Constrain each call by action, target and purpose.

Technical guide

What can this tool cause, and who granted that effect?

Authority architecture

The question

What can this tool cause, and who granted that effect?

TL;DR: discoverability is not permission

An agent may discover an MCP tool or have a tool listed in its runtime without being authorized for every operation that tool can cause. Tool availability is an interface fact. Action authorization must consider the acting agent, user or organization on whose behalf it acts, task purpose, exact operation, target, normalized parameters, valid delegated authority, policy and current risk.

MCP can expose capabilities and manage transport authorization, but application-level authorization still needs to decide whether a particular tool call is allowed. ProofGrid is not described here as shipping an MCP connector. ProofGrid applies the authority model at tool, API and other enforceable action boundaries.

Tools amplify capabilities

An agent tool can search, send, modify, delete, transfer or trigger a physical action. Exposing the tool to an agent does not establish that every operation and target is appropriate. Tool security begins by cataloging the external effects each method can cause.

A read-only search tool and an account-disable tool require different decision boundaries. Even one tool may combine harmless reads with sensitive writes, so permission should attach to the operation and target rather than the tool name alone.

  • Tool operation
  • Target resource
  • External effect
  • Task purpose
  • Approval threshold

Keep the enforcement boundary real

A wrapper can check authority before dispatching a tool call, but direct API paths may bypass it. Agents that can acquire a different credential or call a lower-level tool can escape the intended boundary. Inventory alternate paths and place the check where execution can truly be prevented.

MCP and other tool layers are useful architectural categories, not a guarantee that a specific adapter is shipped. The integration must validate identity propagation from the agent through the tool to the protected system.

Observe what followed

The decision should link to tool response and observed state. A tool timeout may leave uncertainty about whether an action happened. Retries need idempotency or explicit reconciliation for consequential effects.

Tool metadata is not a security boundary

Descriptions, schemas and prompts help an agent choose tools. They do not enforce authorization. A tool may accept a target identifier that reaches far beyond the agent’s task, or expose an operation with a larger effect than its name suggests. The enforcement point must validate the requested effect against authority and policy before calling the underlying API.

Human review should be reserved for decisions that need it. If the tool boundary can distinguish a safe read from a high-risk write, the former may proceed while the latter escalates. That is more useful than either blocking the entire tool or granting it wholesale.

Inventory effects rather than tool names

A tool labeled manage account may read a profile, change a beneficiary, suspend access or release funds. These effects demand different grants and approval thresholds. For each operation, record the target type, possible external change, reversibility, affected parties and data exposure. A harmless-looking sequence can also create a sensitive result, such as reading a record and sending its contents outside the organization.

Tool descriptions and JSON schemas help select and format calls. They are not authorization checks. The boundary must validate trusted identity and task context, resolve a valid grant, apply policy, and reject the call before dispatch when the requested effect is outside scope.

Test bypasses and ambiguous responses

Check whether the agent can reach the underlying API directly, obtain a more powerful credential, or ask another tool to perform the same change. A queue or helper service may also lose the agent and task identity. Protect the execution path that actually changes state, including delayed jobs.

A tool returning success may mean only that a request was accepted. Preserve the returned receipt and confirm the observed outcome when the effect matters. If the response times out, an immediate retry can duplicate a payment or destructive command. Idempotency and reconciliation belong beside authorization in the integration design.

Separate tool, operation and effect

A tool called manage customer may read a record, change contact details, alter a beneficiary or send a payment. An allowlist entry for that tool cannot express the different impact of each operation. Even one operation may be safe for one target but not another, or safe below a value limit but not above it. Normalize and validate parameters before the authorization decision and before a human approval is shown.

Tool descriptions and schemas are useful discovery and input mechanisms, yet they can be changed or poisoned. A descriptive promise that a tool is read-only is not an enforcement guarantee if its backend credential can write. The gate should bind the permitted effect to a trusted execution path, and the integration should inspect direct API routes that could bypass the tool wrapper.

Approval integrity for a high-impact call

An account-disable request should present the exact agent, incident, tool, operation, target account and normalized arguments to the approver. Approval for account A cannot be reused for account B. Keep the authorization artifact short-lived and resistant to replay; a second execution should require a fresh decision or be safely deduplicated. If the agent revises its plan or the target changes while the request waits, the old approval no longer covers it.

For delayed execution, reevaluate parent revocation, approval validity, policy and risk at the last meaningful boundary. A decision at task creation or queue submission may be stale by the time the effect occurs. The backend executor still applies its own domain restrictions and may reject an authorized request.

Failure and evidence cases

High-consequence writes normally stop when authority origin, required policy or approval cannot be validated. Lower-risk diagnostics may continue only within a defined degraded grant. A DEGRADE result that leaves the original write credential usable is not an effective boundary.

Record the authorization decision, tool receipt and observed outcome separately. A timeout does not prove failure or success; the operation may have executed. Reconcile before retrying and use idempotency when available. Link the final evidence to the original task and delegation chain so an investigator can explain both the permission and the actual effect.

MCP and tool review checklist

Review which server exposes each tool, the authenticated server and client identities, backend privileges, schema and description integrity, allowed operations, target validation, direct bypass paths, approval binding, replay behavior, revocation timing and logging. Exercise a malicious or changed tool description, an unauthorized target, a stale approval and an ambiguous timeout. The OWASP AI Agent and MCP security guidance provide broader threat and testing context.

The point of the checklist is not to force every tool call through one universal product. The protected effect may be an API mutation, a queued job, an outbound message or a physical command. Each has a different enforceable boundary and different evidence of completion.