About nostr-server
nostr-server is an MCP server published by git+AustinKelsay in the AI category: a Model Context Protocol (MCP) server that provides Nostr capabilities to LLMs like Claude.
Install
npx nostr-mcp-serverclaude mcp add nostr-mcp-server-gitausti -- npx -y nostr-mcp-servernpx -y nostr-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (40)
analyzeNip19Analyze any NIP-19 entity or hex string to understand its type and contents
Parameters not published.
convertNip19Convert any NIP-19 entity (npub, nsec, note, nprofile, nevent, naddr) to another format
Parameters not published.
createKeypairGenerate a new Nostr keypair
Parameters not published.
createNostrEventCreate an unsigned Nostr event of any kind (requires pubkey or privateKey to derive pubkey)
Parameters not published.
createNoteCreate a new kind 1 note event (unsigned)
Parameters not published.
createProfileCreate a new Nostr profile (kind 0 event)
Parameters not published.
decryptDmNip44Decrypt a NIP-17 gift wrapped DM (kind 1059) to reveal the inner kind 14 rumor
Parameters not published.
decryptNip04Decrypt ciphertext using NIP-04 (AES-CBC) for direct messages
Parameters not published.
decryptNip44Decrypt ciphertext using NIP-44 (ChaCha20 + HMAC)
Parameters not published.
deleteEventDelete one or more events (kind 5 deletion request)
Parameters not published.
Show all 40 tools
encryptNip04Encrypt plaintext using NIP-04 (AES-CBC) for direct messages
Parameters not published.
encryptNip44Encrypt plaintext using NIP-44 (ChaCha20 + HMAC)
Parameters not published.
followFollow a pubkey by updating your contact list (kind 3)
Parameters not published.
getAllZapsGet all zaps (sent and received) for a public key
Parameters not published.
getContactListGet a user
Parameters not published.
getDmConversationNip04Fetch and optionally decrypt a NIP-04 DM conversation (kind 4) between you and a peer
Parameters not published.
getDmInboxNip44Fetch and decrypt your NIP-44 DM inbox (NIP-17 gift wraps, kind 1059)
Parameters not published.
getFollowingGet pubkeys a user is following (alias of getContactList)
Parameters not published.
getKind1NotesGet text notes (kind 1) by public key
Parameters not published.
getLongFormNotesGet long-form notes (kind 30023) by public key
Parameters not published.
getProfileGet a Nostr profile by public key
Parameters not published.
getReceivedZapsGet zaps received by a public key
Parameters not published.
getRelayListGet a user
Parameters not published.
getSentZapsGet zaps sent by a public key
Parameters not published.
postAnonymousNotePost an anonymous note to the Nostr network using a temporary keypair
Parameters not published.
postNotePost a note using an existing private key (authenticated posting)
Parameters not published.
publishNostrEventPublish a signed Nostr event to relays
Parameters not published.
publishNotePublish a signed note to Nostr relays
Parameters not published.
queryEventsQuery Nostr events using a generic filter (kinds/authors/ids/tags/timestamps)
Parameters not published.
reactToEventReact to an event (kind 7)
Parameters not published.
replyToEventReply to an event with correct NIP-10 thread tags (kind 1)
Parameters not published.
repostEventRepost an event (kind 6)
Parameters not published.
sendAnonymousZapPrepare an anonymous zap to a profile or event
Parameters not published.
sendDmNip04Send a NIP-04 encrypted DM (kind 4)
Parameters not published.
sendDmNip44Send a NIP-44 encrypted DM using NIP-17 gift wrap (kind 1059)
Parameters not published.
setRelayListPublish your relay list metadata (NIP-65 kind 10002)
Parameters not published.
signNostrEventSign an unsigned Nostr event with a private key
Parameters not published.
signNoteSign a note event with a private key
Parameters not published.
unfollowUnfollow a pubkey by updating your contact list (kind 3)
Parameters not published.
updateProfileUpdate an existing Nostr profile (kind 0 event)
Parameters not published.
Ask AI
Ask AI about nostr-server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
4 checks have not been run yet.
README
Nostr MCP Server
⚠️ This project is no longer maintained. It has been superseded by nostr-agent-interface — a newer, improved version with additional Blossom file storage support and an expanded tool set.
For the full MCP server with 48 tools, see:
https://github.com/AustinKelsay/nostr-agent-interface
What changed?
The nostr-agent-interface (NAI) builds on this project and adds:
- Blossom file storage — 8 new tools for uploading, downloading, listing, deleting, and mirroring blobs
- Expanded tool count — 48 MCP tools covering profile, notes, relays, DMs, zaps, and now blob storage
- Cleaner architecture — improved module organization and signing via
snstr - Built-in budget monitoring — optional Plaid-connected budget tracking for personal finance
Migrating
If you're using nostr-mcp-server, switch to:
npm install -g nostr-agent-interface
Or point to the source:
git clone https://github.com/AustinKelsay/nostr-agent-interface.git
cd nostr-agent-interface
npm install && npm run build
Old tool count
This repo contains 40 tools (documented in the git history).
The active repo (nostr-agent-interface) has 48 tools.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.