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
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install mcp-pin - Said no? Turn it on later:
hermes plugins enable mcp-pin - 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

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