Skip to content
MCP server

Nostr Ops MCP

Nostr publishing, queries, and DMs for AI agents, with allowlists, rate limits, and an…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.3
Listing updated
5 days ago

About Nostr Ops MCP

Nostr Ops MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Nostr publishing, queries, and DMs for AI agents, with allowlists, rate limits, and an audit log.

Install

Run in a terminal

claude mcp add nostr-ops-mcp --env NOSTR_RELAYS='<NOSTR_RELAYS>' --env NOSTR_NIP46_URI='<NOSTR_NIP46_URI>' --env NOSTR_PRIVATE_KEY='<NOSTR_PRIVATE_KEY>' -- npx -y nostr-ops-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nostr-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nostr-ops-mcp"
      ],
      "env": {
        "NOSTR_RELAYS": "<NOSTR_RELAYS>",
        "NOSTR_NIP46_URI": "<NOSTR_NIP46_URI>",
        "NOSTR_PRIVATE_KEY": "<NOSTR_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nostr-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nostr-ops-mcp"
      ],
      "env": {
        "NOSTR_RELAYS": "<NOSTR_RELAYS>",
        "NOSTR_NIP46_URI": "<NOSTR_NIP46_URI>",
        "NOSTR_PRIVATE_KEY": "<NOSTR_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "nostr-ops-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "nostr-ops-mcp"
      ],
      "env": {
        "NOSTR_RELAYS": "<NOSTR_RELAYS>",
        "NOSTR_NIP46_URI": "<NOSTR_NIP46_URI>",
        "NOSTR_PRIVATE_KEY": "<NOSTR_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nostr-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nostr-ops-mcp"
      ],
      "env": {
        "NOSTR_RELAYS": "<NOSTR_RELAYS>",
        "NOSTR_NIP46_URI": "<NOSTR_NIP46_URI>",
        "NOSTR_PRIVATE_KEY": "<NOSTR_PRIVATE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "nostr-ops-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nostr-ops-mcp"
      ],
      "env": {
        "NOSTR_RELAYS": "<NOSTR_RELAYS>",
        "NOSTR_NIP46_URI": "<NOSTR_NIP46_URI>",
        "NOSTR_PRIVATE_KEY": "<NOSTR_PRIVATE_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • NOSTR_RELAYSComma-separated wss:// relay URLsRequired
  • NOSTR_NIP46_URINIP-46 bunker URI (preferred signer; keeps the nsec off this machine)
  • NOSTR_PRIVATE_KEYnsec private key (alternative to NOSTR_NIP46_URI; read-only mode if neither is set)
  • NOSTR_ALLOWED_KINDSComma-separated event kinds the server may publish (required when a signer is configured)

Pricing

Open source

Nostr Ops MCP FAQ

Is Nostr Ops MCP free?

Yes. Nostr Ops MCP is open source, so you can use and self-host it for free.

How do I add Nostr Ops MCP to Claude Code?

Run this command in your terminal: claude mcp add nostr-ops-mcp --env NOSTR_RELAYS='<NOSTR_RELAYS>' --env NOSTR_NIP46_URI='<NOSTR_NIP46_URI>' --env NOSTR_PRIVATE_KEY='<NOSTR_PRIVATE_KEY>' -- npx -y nostr-ops-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers