Nostr MCP Server

by MCP-Mirror

627 downloads Not rated yet MIT license

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.