change_keyword · YOURLS- MCP: Risk & Policy

WHAT IT DOES

What change_keyword does on YOURLS-MCP

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

WHY IT NEEDS A POLICY

Why change_keyword needs a policy

This tool modifies an existing record (the keyword/slug of a short URL) which is a reversible write operation. It does not delete data, execute code, or involve financial transactions. Misuse could cause broken links or redirect hijacking, hence medium severity.

From the tool's definition Change the keyword of an existing short URL

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

change_keyword Rate-limited

change_keyword 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": {
    "change_keyword": {
      "limits": [
        {
          "counter": "change_keyword_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 YOURLS-MCP, so you can run agents against it safely.

FAQ

Questions about change_keyword

What does the change_keyword tool do? +

Change the keyword of an existing short URL. It is categorised as a Write tool in the YOURLS-MCP MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on change_keyword? +

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

What risk level is change_keyword? +

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

Can I rate-limit change_keyword? +

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

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

change_keyword is provided by the YOURLS- MCP server (kesslerio/yourls-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.