nostr-mcp-server

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