color_structure · ChimeraX MCP Server MCP: Risk & Policy

WHAT IT DOES

What color_structure does on ChimeraX MCP Server

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

WHY IT NEEDS A POLICY

Why color_structure needs a policy

This tool changes structural visualization attributes (colors) but does not delete data, execute arbitrary code, or cause irreversible damage. The modification is fully reversible (colors can be changed again or reset), making it Write rather than Destructive or Execute. In a scientific context, misuse could corrupt or mislead analysis of protein structures, but the operation itself is non-destructive.

From the tool's definition Tool modifies visual properties of protein structures through 'color...by scheme' or 'named/hex color' operations, changing the state of the structure visualization in a reversible manner.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

color_structure Rate-limited

color_structure 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": {
    "color_structure": {
      "limits": [
        {
          "counter": "color_structure_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 ChimeraX MCP Server, so you can run agents against it safely.

FAQ

Questions about color_structure

What does the color_structure tool do? +

Color atoms/residues by scheme (chain, bfactor, rainbow) or a named/hex color. It is categorised as a Write tool in the ChimeraX MCP Server MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on color_structure? +

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

What risk level is color_structure? +

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

Can I rate-limit color_structure? +

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

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

color_structure is provided by the ChimeraX MCP Server MCP server (mahynotch/chimerax-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.