Nostr Ops MCP
Nostr publishing, queries, and DMs for AI agents, with allowlists, rate limits, and an…
- 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-mcpAdd 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 URLsRequiredNOSTR_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.