configs · Metalsmith Plugin MCP: Risk & Policy

WHAT IT DOES

What configs does on Metalsmith Plugin

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

WHY IT NEEDS A POLICY

Why configs needs a policy

The tool generates (creates/writes) configuration files following defined standards. This is a Write operation as it creates new files, which is reversible (files can be deleted or overwritten). The blast radius is medium since misconfigured or maliciously crafted config files could affect how Metalsmith plugins behave, but the action itself is a standard file creation operation.

From the tool's definition "Generate configuration files" indicates creating/writing new files to the filesystem

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

configs Rate-limited

configs 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": {
    "configs": {
      "limits": [
        {
          "counter": "configs_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 Metalsmith Plugin, so you can run agents against it safely.

FAQ

Questions about configs

What does the configs tool do? +

Generate configuration files following enhanced standards. It is categorised as a Write tool in the Metalsmith Plugin MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on configs? +

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

What risk level is configs? +

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

Can I rate-limit configs? +

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

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

configs is provided by the Metalsmith Plugin MCP server (metalsmith-plugin-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.