hydra_toggle_pin · Hydra Bridge MCP: Risk & Policy

WHAT IT DOES

What hydra_toggle_pin does on Hydra Bridge

AI agents use hydra_toggle_pin to create or update resources in Hydra Bridge — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Hydra Bridge environment.

WHY IT NEEDS A POLICY

Why hydra_toggle_pin needs a policy

This tool creates or modifies library metadata (pin status) reversibly. The user can toggle the pin state at any time, so it is a Write operation rather than Destructive. The blast radius is minimal — an unintended pin/unpin changes only UI organization with no data loss or external side effects.

From the tool's definition Pin or unpin a game in the library — modifies the organization state of a game in the user's library without permanently deleting or destroying data.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

hydra_toggle_pin Rate-limited

hydra_toggle_pin stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "hydra_toggle_pin": {
      "limits": [
        {
          "counter": "hydra_toggle_pin_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL →

Instant setup, no code required.

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

FAQ

Questions about hydra_toggle_pin

What does the hydra_toggle_pin tool do? +

Pin or unpin a game in the library. It is categorised as a Write tool in the Hydra Bridge MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on hydra_toggle_pin? +

Register the Hydra Bridge MCP server in PolicyLayer and add a rule for hydra_toggle_pin: 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 Hydra Bridge. Nothing to install.

What risk level is hydra_toggle_pin? +

hydra_toggle_pin is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit hydra_toggle_pin? +

Yes. Add a rate_limit block to the hydra_toggle_pin 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 hydra_toggle_pin completely? +

Set action: deny in the PolicyLayer policy for hydra_toggle_pin. 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 hydra_toggle_pin? +

hydra_toggle_pin is provided by the Hydra Bridge MCP server (kleirrampage45/hydra-bridge). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.