MCP Pin

From its catalog listing

Hold MCP tools whose definition changed since you approved them. Fingerprints every MCP tool's description and parameter schema as Hermes registered it; if a server later changes a tool (a rug pull, instructions hidden in a description, a new parameter) or adds a tool to a pinned server, the new definition is hidden from the model (tool list, tool_search catalog, tool_describe) and calls to that tool are refused until the owner reviews the full change with /mcppin diff and approves exactly that definition with the code it shows. Works with tool_search on or off and with every provider wire format (not the Codex app-server runtime, where Codex calls MCP servers directly). Fails closed: an unreadable or deleted pin file withholds MCP definitions and refuses MCP calls.

Good to know before installing

llm_request middleware rewrites only held MCP tool definitions in the outgoing request (their tool entry or tool_search catalog line); tool_execution middleware rewrites only tool_search / tool_describe / tool_call results that carry a held definition; pre_tool_call may block a call to a held MCP tool (never modifies arguments, never approves, never touches the approval system); registers /mcppin; reads only its own settings, MCP tool definitions from the tool registry, the per-message session identity, and Hermes's allow_admin_from / group_allow_admin_from lists through the gateway config loader when an approval is attempted from a chat; writes pins.json and a transient lock file (MCP tool names, descriptions, parameter schemas, timestamps, approver) in its plugin data directory, and its own store_id setting (a random id that lets a deleted pin file be detected); no network calls, no shell commands, no background processes, no telemetry, no credential reads, no self-update. Not a sandbox: an approved tool keeps its normal reach.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install mcp-pin
  2. Said no? Turn it on later:
    hermes plugins enable mcp-pin
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Coding & developer tools
Maintained by
yuzuru99 (Community)
Needs
No API keys declared
Adds hooks
pre_tool_call
Needs Hermes
0.23.0 or newer
Version
1.0.0
In the catalog
2026-11-10
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in coding & developer tools

All coding & developer tools plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins