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/mcp

Transport: 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:

1. Open any Nostr client (Amethyst, Primal, Damus, etc.)
2. DM this npub: npub16pg5zadrrhseg2qjt9lwfcl50zcc8alnt7mnaend3j04wjz4gnjqn6efzc
3. Send the message: register yourname
4. Pay the Lightning invoice that arrives in reply (1,000 sats)
5. Done — yourname@jorgenclaw.ai resolves 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_URI once, all signing routes through your bunker
• Direct key mode — Pass privateKey per-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 build

Direct key mode (no bunker)

node dist/index.js

Tools 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.js

All 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/mcp

9 tools, sats per call, LCS-1 action receipts. No signup.

Dependencies

• nostr-tools — Nostr protocol library (signing, encryption, NIP-46)
• @modelcontextprotocol/sdk — MCP server framework
• ws — WebSocket for Node.js relay connections
• zod — Input validation

License

MIT