Nostr MCP
A Model Context Protocol server that enables LLMs like Claude to interact with the Nostr social network, allowing for fetching user profiles, text notes, and zap payment information.
What is Nostr MCP?
Nostr MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that enables llms like claude to interact with the nostr social network, allowing for fetching user profiles, text notes, and zap payment information.
A Model Context Protocol server that enables LLMs like Claude to interact with the Nostr social network, allowing for fetching user profiles, text notes, and zap payment information.
This server falls under the Communication and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that enables LLMs like Claud
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx nostr-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Nostr MCP
Nostr MCP Server is a Model Context Protocol server that connects LLMs like Claude to the Nostr decentralised social network, enabling retrieval of user profiles, text notes, relay information, direct messages, and Lightning zap payment data. It exposes around 40 tools that map to core Nostr operations, making it straightforward for an AI assistant to browse or interact with the open, censorship-resistant social protocol. Developers and Bitcoin/Lightning users will find it useful for building AI-powered Nostr clients or automating social interactions on the protocol.
Prerequisites
- Node.js 18 or later installed
- An MCP-compatible client such as Claude Desktop
- A Nostr private key (nsec) or the npub/hex public key of profiles you want to query
- Access to at least one public Nostr relay (e.g. wss://relay.damus.io)
Run the server with npx
The server can be started directly using npx without a global install. Note that the project is no longer actively maintained; the successor is nostr-agent-interface.
npx nostr-mcp-serverObtain a Nostr key pair
To perform write operations (posting notes, sending DMs, zapping), you need a Nostr private key in nsec or hex format. For read-only profile and note queries you only need the target public key (npub or hex).
Add the server to your MCP client config
Edit claude_desktop_config.json to register the Nostr MCP server. Pass your private key in the env block if you want write access.
{
"mcpServers": {
"nostr": {
"command": "npx",
"args": ["nostr-mcp-server"]
}
}
}Restart Claude Desktop
Fully quit and reopen Claude Desktop so it picks up the new server configuration and establishes connections to Nostr relays.
Query Nostr profiles and notes
The server exposes tools for fetching profiles, listing notes from a public key, retrieving relay lists, reading direct messages, and accessing zap receipt data. Ask Claude to use these tools with a specific npub or hex public key.
Nostr MCP Examples
Client configuration
Claude Desktop configuration block for the Nostr MCP Server.
{
"mcpServers": {
"nostr": {
"command": "npx",
"args": ["nostr-mcp-server"]
}
}
}Prompts to try
Example prompts for interacting with the Nostr social network through Claude.
- "Fetch the Nostr profile for npub1a2b3c... and summarise their bio."
- "Show the last 10 notes posted by this Nostr public key: <hex>."
- "List the relays this Nostr user is subscribed to."
- "Get the zap receipts for this npub and tell me the total amount received."
- "Fetch any direct messages in the Nostr inbox for my public key."Troubleshooting Nostr MCP
Relay connection errors or empty results when fetching notes
Nostr relies on publicly available relays. If the default relay is unreachable, specify an alternative public relay (e.g. wss://nos.lol or wss://relay.nostr.band) in the server's relay configuration or as a parameter in the tool call.
The project appears unmaintained and missing features
This repository is no longer actively maintained. Consider migrating to the successor project nostr-agent-interface (npm install -g nostr-agent-interface), which offers 48 tools and active development.
Write operations (posting notes, zapping) fail
Write operations require a valid Nostr private key. Ensure your nsec or hex private key is correctly configured and that you are using a relay that accepts authenticated events.
Frequently Asked Questions about Nostr MCP
What is Nostr MCP?
Nostr MCP is a Model Context Protocol (MCP) server that model context protocol server that enables llms like claude to interact with the nostr social network, allowing for fetching user profiles, text notes, and zap payment information. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Nostr MCP?
Follow the installation instructions on the Nostr MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Nostr MCP?
Nostr MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Nostr MCP free to use?
Yes, Nostr MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Nostr MCP Alternatives — Similar Communication Servers
Looking for alternatives to Nostr MCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Nostr MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Nostr MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.