Medium Risk

unpin_message

Unpin a message in a channel.

How to control unpin_message ↓

What unpin_message does on Discord

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

Medium Risk

Why unpin_message needs a policy

This is a Write operation because it modifies channel state (message pin status) in a reversible manner. It is not Destructive because the message and its content remain intact; unpinning can be reversed by pinning again.

From the tool's definition Tool name 'unpin_message' and description 'Unpin a message in a channel' indicate a reversible modification operation. The action removes a pinned status from a message but does not delete the message itself.

Documented attack patterns abuse exactly the kind of access unpin_message gives an agent:

How to control unpin_message

PolicyLayer is an MCP gateway — it sits between your AI agents and Discord, and nothing reaches the server without passing your rules. This is the rule we recommend for unpin_message:

policy.json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "unpin_message": {
      "limits": [
        {
          "counter": "unpin_message_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

unpin_message 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.

  1. Create a free account and register Discord — nothing to install.
  2. Add this policy — paste it, or build it visually.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
LIMIT THIS TOOL →

Free to start. No card required.

Related tools and policies

Go deeper

Questions about unpin_message

What does the unpin_message tool do? +

Unpin a message in a channel. It is categorised as a Write tool in the Discord MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on unpin_message? +

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

What risk level is unpin_message? +

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

Can I rate-limit unpin_message? +

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

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

unpin_message is provided by the Discord MCP server (hardheadhackerhead/discord-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every Discord tool call.

Start from Discord, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

Free to start. No card required.

139 Discord tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.