🌐 Nostr MCP Server

Name: 🌐 Nostr MCP Server
Author: AbdelStark

@AbdelStark

Repository

About 🌐 Nostr MCP Server

A Nostr MCP server that allows to interact with Nostr, enabling posting notes, and more.

#nostr #llm #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "nostr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@AbdelStark/nostr-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Nostr MCP Server?

Nostr MCP Server is a Model Context Protocol (MCP) server that enables AI models to interact with the Nostr decentralized social network. It allows LLMs to post notes and engage with the freedom‑of‑speech protocol.

How to use Nostr MCP Server?

Install via Smithery (npx -y @smithery/cli install @AbdelStark/nostr-mcp --client claude) or clone the repository, install dependencies (npm install), and create a .env file with your Nostr private key and relay list. Run with npm run dev (development) or npm start (production). The server exposes tools post_note and send_zap via MCP.

Key features of Nostr MCP Server

Post notes to the Nostr network
Connect to multiple relays at once
MCP‑compliant API for AI integration
Send Lightning zaps to Nostr users (work in progress)
Server‑Sent Events (SSE) support for real‑time communication

Use cases of Nostr MCP Server

An AI assistant publishing announcements or updates to Nostr
Automated content distribution across Nostr relays
Allowing LLMs to send micropayments via Lightning zaps
Censorship‑resistant messaging from AI agents

FAQ from Nostr MCP Server

What does Nostr MCP Server do?

It acts as a bridge between MCP‑compatible AI models and the Nostr protocol, allowing models to post notes and send Lightning zaps directly to the Nostr network.

What are the runtime requirements?

Node.js version 18 or higher is required.

Do I need a Nostr private key?

Yes. You must set the NOSTR_NSEC_KEY environment variable (a nsec‑format key) to authenticate and publish notes.

Which Nostr relays does it connect to by default?

The default relays are wss://relay.damus.io, wss://relay.primal.net, and wss://nos.lol. You can configure a custom list via the NOSTR_RELAYS environment variable.