MCP.so
Sign In

Nostr MCP Server

@AbdelStark

Basic information

Category

Other

License

MIT

Transports

stdio

Author

AbdelStark

About Nostr MCP Server

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

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

1

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.

2

What are the runtime requirements?

Node.js version 18 or higher is required.

3

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.

4

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.

5

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