agents · iTerm MCP: Risk & Policy

WHAT IT DOES

What agents does on iTerm MCP

AI agents call agents as a supporting operation in iTerm MCP workflows.

WHY IT NEEDS A POLICY

Why agents needs a policy

The description is empty and uninformative, making it impossible to determine what this tool does with confidence. The name 'agents' in the context of an iTerm MCP server with AI orchestration capabilities could relate to managing AI agents, but without evidence of specific actions (read, write, execute, etc.), classification defaults to Other. Confidence is low due to lack of description.

From the tool's definition Tool name is 'agents' with an empty description. No functional details are available.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

agents Rate-limited

agents gets a rate cap, and everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "agents": {
      "limits": [
        {
          "counter": "agents_rate",
          "window": "minute",
          "max": 60,
          "scope": "grant"
        }
      ]
    }
  }
}

SET A RULE FOR THIS TOOL →

Instant setup, no code required.

PolicyLayer is an MCP gateway: every tool call is checked against your rule before it reaches iTerm MCP, so you can run agents against it safely.

FAQ

Questions about agents

What does the agents tool do? +

agents. It is categorised as a Other tool in the iTerm MCP MCP Server, which means it performs auxiliary operations.

How do I enforce a policy on agents? +

Register the iTerm MCP server in PolicyLayer and add a rule for agents: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches iTerm MCP. Nothing to install.

What risk level is agents? +

agents is a Other tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit agents? +

Yes. Add a rate_limit block to the agents rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block agents completely? +

Set action: deny in the PolicyLayer policy for agents. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides agents? +

agents is provided by the iTerm MCP server (research-developer/iterm-mcp-claude-agency). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.