Nostr MCP Server
Sign and publish Nostr events, paid per call in sats over Lightning.
What can you do with Nostr MCP Server?
- NIP-46 bunker mode — Set
NOSTR_BUNKER_URIonce, all signing routes through your bunker - Direct key mode — Pass
privateKeyper-tool call (backwards compatible) - 23 tools — Notes, profiles, social actions, DMs (NIP-04/44), relay lists, zaps, fetch
- MCP native — Works with any MCP-compatible client
Install
The installation steps are in the documentation below. Documentation
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
nostr-mcp-server
A Nostr MCP (Model Context Protocol) server with NIP-46 remote signing support. Private keys never need to touch the AI context window.
Live Endpoint
Connect directly without running locally:
https://nostr.jorgenclaw.ai/mcpTransport: Streamable HTTP (MCP spec 2025-03-26) — compatible with Claude Desktop, Cursor, Glama, Smithery, and any MCP client.
Legacy SSE endpoint (backward compat): https://nostr.jorgenclaw.ai/sse
NIP-05 Identity Service
Get a yourname@jorgenclaw.ai verified Nostr identity — registered by an AI agent over Lightning.
How to register:
- Open any Nostr client (Amethyst, Primal, Damus, etc.)
- DM this npub:
npub16pg5zadrrhseg2qjt9lwfcl50zcc8alnt7mnaend3j04wjz4gnjqn6efzc - Send the message:
register yourname - Pay the Lightning invoice that arrives in reply (1,000 sats)
- Done —
yourname@jorgenclaw.airesolves immediately on all Nostr clients
Uses NIP-17 gift-wrapped DMs. Works with all modern Nostr clients.
Features
- NIP-46 bunker mode — Set
NOSTR_BUNKER_URIonce, all signing routes through your bunker - Direct key mode — Pass
privateKeyper-tool call (backwards compatible) - 23 tools — Notes, profiles, social actions, DMs (NIP-04/44), relay lists, zaps, fetch
- MCP native — Works with any MCP-compatible client
Quick Start
npm install
npm run buildDirect key mode (no bunker)
node dist/index.jsTools require privateKey parameter on each signing call.
Bunker mode (recommended)
NOSTR_BUNKER_URI="bunker://<pubkey>?relay=wss://relay.example.com&secret=abc" node dist/index.jsAll signing tools use the bunker. privateKey parameter becomes optional.
Tools
| Tool | Description |
|---|---|
postNote | Create, sign, and publish a text note |
createNote | Create unsigned text note |
signNote | Sign a note event |
publishNote | Publish signed note to relays |
createNostrEvent | Create unsigned event of any kind |
signNostrEvent | Sign any unsigned event |
publishNostrEvent | Publish signed event to relays |
createProfile | Create Nostr profile (kind 0) |
updateProfile | Update existing profile |
follow | Follow a pubkey |
unfollow | Unfollow a pubkey |
reactToEvent | React to event (kind 7) |
repostEvent | Repost event (kind 6) |
deleteEvent | Delete events (kind 5) |
replyToEvent | Reply with NIP-10 threading |
encryptNip04 / decryptNip04 | NIP-04 encryption |
sendDmNip04 | Send NIP-04 DM |
encryptNip44 / decryptNip44 | NIP-44 encryption |
sendDmNip44 | Send NIP-44 DM |
setRelayList | Publish relay list (NIP-65) |
getSignerInfo | Check signing mode and pubkey |
fetchProfile | Fetch a Nostr profile |
fetchEvents | Fetch events from relays |
NIP-46 Bunker URI
Format: bunker://<bunker-hex-pubkey>?relay=wss://relay.com&secret=optional
Compatible with: nsecbunker, Amber, any NIP-46 signer.
Also Available: Sovereign MCP (Paid)
For agents that need verifiable signed actions with a Lightning-gated audit trail:
https://mcp.jorgenclaw.ai/mcp9 tools, sats per call, LCS-1 action receipts. No signup.
Dependencies
nostr-tools— Nostr protocol library (signing, encryption, NIP-46)@modelcontextprotocol/sdk— MCP server frameworkws— WebSocket for Node.js relay connectionszod— Input validation
License
MIT
Frequently asked questions
What is Nostr MCP Server?
Sign and publish Nostr events, paid per call in sats over Lightning.
How do I install Nostr MCP Server?
Follow the installation steps in its documentation, shown on this page and in its repository.
Is Nostr MCP Server open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Nostr MCP Server?
It is published by jorgenclaw. AI.tn lists it but does not maintain or endorse it.
From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.