Nostr MCP Server logo

Nostr MCP Server

by MCP-Mirror

The Nostr MCP Server provides Nostr capabilities to LLMs like Claude, enabling them to interact with the Nostr network. It implements a Model Context Protocol (MCP) server.

View on GitHub

Last updated: N/A

What is Nostr MCP Server?

The Nostr MCP Server is a server that acts as a bridge between Large Language Models (LLMs) and the Nostr network. It allows LLMs like Claude and Cursor to access and interact with data on the Nostr network through a set of predefined tools.

How to use Nostr MCP Server?

To use the server, you need to install it, configure your LLM (Claude or Cursor) to connect to it, and then use natural language requests to query the Nostr network through the LLM. The README provides detailed instructions for installation and configuration.

Key features of Nostr MCP Server

  • Fetches user profile information

  • Retrieves text notes and long-form content

  • Fetches sent and received zaps with payment details

  • Searches through Nostr Implementation Possibilities (NIPs)

  • Supports both hex public keys and npub format

  • Allows specifying custom relays for queries

  • Enables validation and debugging for zap queries

Use cases of Nostr MCP Server

  • Retrieving user profiles from Nostr

  • Analyzing user activity and content on Nostr

  • Tracking zap transactions and financial activity

  • Researching and understanding Nostr protocols (NIPs)

  • Integrating Nostr data into LLM-powered applications

FAQ from Nostr MCP Server

What is the default timeout for queries?

The server has a default 8-second timeout for queries.

What key formats are supported?

Only public keys in hex format or npub format are supported.

What relays are used by default?

The server uses a subset of relays by default, including wss://relay.damus.io, wss://relay.nostr.band, wss://relay.primal.net, wss://nos.lol, wss://relay.current.fyi, and wss://nostr.bitcoiner.social.

How do I specify custom relays?

You can specify custom relays in your queries, e.g., 'Show me the profile for npub1... using relay wss://relay.damus.io'

How do I increase the query timeout?

You can increase the QUERY_TIMEOUT value in the source code (index.ts).