Nostr MCP Server

@AbdelStark

Repository

Basic information

About Nostr MCP Server

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

#nostr #llm #mcp-server

Nostr MCP Server 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"
      ]
    }
  }
}

Nostr MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

Frequently asked questions

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.

What transport modes are supported?

The server supports SSE (Server‑Sent Events) mode by default. Stdin transport mode is planned but not yet implemented.

Comments

More Other MCP servers

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov