iamredmh/volta-mcp-server

MCP server for Volta Notes — create and read **burn-after-read** encrypted notes from any AI agent.
Notes are **end-to-end encrypted** using AES-256-GCM. The decryption key lives only in the URL fragment — it is never sent to any server. Notes are stored on the Internet Computer and permanently destroyed after a single read.
Why
AI agents regularly need sensitive information at runtime — API keys, passwords, credentials. Today, users paste these into chat where they're stored permanently in conversation history.
With this MCP server, the pattern becomes:
1. User creates a note at voltanotes.com and sends the one-time URL
2. Agent calls read_volta_note — secret returned, note permanently destroyed
3. Nothing sensitive ever appears in chat history
Or in reverse — an agent can use create_volta_note to send credentials to a user via a self-destructing link.
Quick Start
Claude Code (CLI & Desktop App)
**Step 1 — Install globally:**
**Step 2 — Register the server:**
That's it. Restart Claude Code and the create_volta_note and read_volta_note tools will be available.
> **Why claude mcp add instead of editing config files?** Claude Code reads MCP servers from its own registry, not from ~/.claude/mcp.json. Using the CLI ensures the server is registered correctly. The -s user flag makes it available across all projects.
> **node not found?** Use the full path: replace node with the output of which node (e.g. /usr/local/bin/node).
Claude Desktop (Standalone)
Add to your claude_desktop_config.json:
Other MCP-compatible clients
The npx config above works with any client that supports the standard command/args MCP format — including **Cursor**, **Windsurf**, **Cline**, **Continue.dev**, and others. Check your client's MCP documentation for where to add server config.
Hermes Agent (Nous Research)
Volta MCP works with Hermes Agent via its MCP integration. Add the server to your Hermes config (~/.hermes/config.yaml):
Restart Hermes and the create_volta_note and read_volta_note tools will be available to your agent.
**Agent-to-agent use case:** Hermes agents running autonomously often need to pass credentials between workflows without exposing them in logs or memory. Volta Notes is purpose-built for this — one agent creates a note, passes the one-time URL to the next, and the secret is destroyed on read. Nothing persists in conversation history or tool output logs.
See Hermes MCP documentation for full configuration options.
Windows (Claude Code CLI)
The $(npm root -g) syntax doesn't work in PowerShell or CMD. Use this instead:
Or use the Claude Desktop / npx method above, which works cross-platform.
Tools
create_volta_note
Creates an encrypted note and returns a one-time URL.
| Parameter | Type | Description |
|-----------|--------|--------------------------------------|
| content | string | Secret content to encrypt (max 2 KB) |
**Returns:** A voltanotes.com URL. The recipient opens it once, reads the content, and it's gone forever.