A Model Context Protocol (MCP) server that enables AI models to interact with Nostr, allowing them to post notes and interact with the freedom of speech protocol. Censorship resistance matters, even for LLMs. BTW, you should join Nostr now! - 📝 Post notes to Nostr network - 🔌 Connect to multiple relays - 🤖 MCP-compliant API for AI integration - 💸 Send Lightning zaps to Nostr users (WIP) - 📡 S
Add this skill
npx mdskills install AbdelStark/nostr-mcpWell-documented MCP server enabling Nostr protocol integration with clear setup and useful social tools
A Model Context Protocol (MCP) server that enables AI models to interact with Nostr, allowing them to post notes and interact with the freedom of speech protocol.
Censorship resistance matters, even for LLMs.
BTW, you should join Nostr now!
To install Nostr MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @AbdelStark/nostr-mcp --client claude
git clone https://github.com/AbdelStark/nostr-mcp
cd nostr-mcp
npm install
.env file:💡 You can copy the
.env.examplefile and modify it as needed.
# Log level (debug, info, warn, error)
LOG_LEVEL=debug
# Node environment (development, production)
NODE_ENV=development
# List of Nostr relays to connect to
NOSTR_RELAYS=wss://relay.damus.io,wss://relay.primal.net,wss://nos.lol
# Your Nostr private key (starts with nsec)
NOSTR_NSEC_KEY=your_nsec_key_here
# Server mode (stdio or sse)
SERVER_MODE=sse
# Port for SSE mode
PORT=9000
# Development mode with hot reload
npm run dev
# Production mode
npm start
post_notePosts a new note to the Nostr network.
Example input:
{
"content": "Hello from Nostr! 👋"
}
send_zapSends a Lightning zap to a Nostr user.
Example input:
{
"nip05Address": "user@domain.com",
"amount": 1000
}
nostr-mcp/
├── src/
│ ├── index.ts # Main server entry point
│ ├── nostr-client.ts # Nostr client implementation
│ └── types.ts # TypeScript type definitions
├── .env # Environment configuration
└── tsconfig.json # TypeScript configuration
npm test
git checkout -b feature/amazing-feature)git commit -m 'Add some amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
Feel free to follow me if you'd like, using my public key:
npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29
Or just scan this QR code to find me:
Made with ❤️ for the Nostr community
Install via CLI
npx mdskills install AbdelStark/nostr-mcpNostr MCP Server is a free, open-source AI agent skill. A Model Context Protocol (MCP) server that enables AI models to interact with Nostr, allowing them to post notes and interact with the freedom of speech protocol. Censorship resistance matters, even for LLMs. BTW, you should join Nostr now! - 📝 Post notes to Nostr network - 🔌 Connect to multiple relays - 🤖 MCP-compliant API for AI integration - 💸 Send Lightning zaps to Nostr users (WIP) - 📡 S
Install Nostr MCP Server with a single command:
npx mdskills install AbdelStark/nostr-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
Nostr MCP Server works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.