Nostr MCP Server
About
A Model Context Protocol (MCP) server that gives LLMs like Claude tools to read public profiles, text notes, long-form content, and zaps from the Nostr network.
Details
- License
- MIT license
Explore
This server implements seven tools for interacting with the Nostr network:
1. getProfile: Fetches a user's profile information by public key
2. getKind1Notes: Fetches text notes (kind 1) authored by a user
3. getLongFormNotes: Fetches long-form content (kind 30023) authored by a user
4. getReceivedZaps: Fetches zaps received by a user, including detailed payment information
5. getSentZaps: Fetches zaps sent by a user, including detailed payment information
6. getAllZaps: Fetches both sent and received zaps for a user, clearly labeled with direction and totals
7. searchNips: Search through Nostr Implementation Possibilities (NIPs) with relevance scoring
All tools fully support both hex public keys and npub format, with user-friendly display of Nostr identifiers.
```bash
npm install
Once configured, you can ask Claude to use the Nostr tools by making requests like:
- "Show me the profile information for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
- "What are the recent posts from npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8?"
- "Show me the long-form articles from npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
- "How many zaps has npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 received?"
- "Show me the zaps sent by npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
- "Show me all zaps (both sent and received) for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
- "Search for NIPs about zaps"
- "What NIPs are related to long-form content?"
- "Show me NIP-23 with full content"
The server automatically handles conversion between npub and hex formats, so you can use either format in your queries. Results are displayed with user-friendly npub identifiers.
You can specify custom relays for any query:
- "Show me the profile for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 using relay wss://relay.damus.io"
You can also specify the number of notes or zaps to fetch:
- "Show me the latest 20 notes from npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
For zap queries, you can enable extra validation and debugging:
- "Show me all zaps for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 with validation and debug enabled"
For NIP searches, you can control the number of results and include full content:
- "Search for NIPs about zaps with full content"
- "Show me the top 5 NIPs about relays"
- "What NIPs are related to encryption? Show me 15 results"
A Model Context Protocol (MCP) server that provides Nostr capabilities to LLMs like Claude.
https://github.com/user-attachments/assets/1d2d47d0-c61b-44e2-85be-5985d2a81c64
Features
This server implements seven tools for interacting with the Nostr network:
1. getProfile: Fetches a user's profile information by public key
2. getKind1Notes: Fetches text notes (kind 1) authored by a user
3. getLongFormNotes: Fetches long-form content (kind 30023) authored by a user
4. getReceivedZaps: Fetches zaps received by a user, including detailed payment information
5. getSentZaps: Fetches zaps sent by a user, including detailed payment information
6. getAllZaps: Fetches both sent and received zaps for a user, clearly labeled with direction and totals
7. searchNips: Search through Nostr Implementation Possibilities (NIPs) with relevance scoring
All tools fully support both hex public keys and npub format, with user-friendly display of Nostr identifiers.
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



