Nostrbook MCP: AI-Ready Developer Documentation for Nostr

Cover Image for Nostrbook MCP: AI-Ready Developer Documentation for Nostr
M. K. Fain
M. K. Fain

A New Era of Building on Nostr

If you’ve ever tried building on Nostr and found yourself hopping between NIPs, blog posts, and example code scattered across the internet, you're not alone. This isn't just a problem for humans, it's a major hurdle for AI systems too.

The Nostr ecosystem is growing rapidly, with new protocols, libraries, and tools emerging every day. But as a developer, you need a reliable source of truth to understand how everything fits together. You need structured documentation that’s easy to query and understand, so you can stop copy/pasting NIPs and code snipets into your AI agent.

That’s exactly the problem Nostrbook solves.


What is Nostrbook MCP?

Using Nostrbook MCP
Using Nostrbook MCP

MCP stands for Model-Context Protocol. It’s a format designed to help AI models better understand and interact with structured information.

Instead of trying to parse random Github pages, Nostrbook MCP delivers clean, normalized representations of the entire Nostr spec in AI-friendly markdown pages. Our llms.txt file at the root of the site also provides a structured overview of key resources for AI agents.

This means you (or your AI assistant) can now do things like:

  • Find exactly how a specific tag works in a given NIP
  • Get a complete schema of a Nostr event, including all fields and their constraints
  • Understand relay behavior defined across multiple NIPs
  • Generate contextual examples for any part of the protocol
  • Power LLM agents with reliable, up-to-date source material

Try Nostrbook MCP with your Favorite AI Code Assistants

Use NostrBook MCP with Goose

Goose is an open-source AI interface developed by Block. To install the Nostr MCP as a Goose extension:

  1. Run goose configure
  2. Choose "Add Extension"
  3. Choose "Command-line Extension"
  4. Enter "nostr" as the name
  5. Enter the command: goose install mcp
  6. Enter "10" seconds
  7. "No" to adding a description
  8. "No" to adding environment variables
Install Nostrbook MCP with Goose

Now when you run goose, it will automatically use the MCP when it needs to know about Nostr.

Use Nostrbook MCP with VSCode

If you're using Visual Studio Code with GitHub Copilot, you can integrate Nostr MCP by creating a .vscode/mcp.json file in your project:

{
  "servers": {
    "nostr": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "xjsr", "@nostrbook/mcp"]
    }
  }
}

This allows Copilot to access Nostr documentation directly. For more information, see Use MCP servers in VS Code.


Try Our Other Tools for the Best Nostr Development Experience

Nostrbook MCP is just one part of a growing toolkit designed to make building on Nostr easier and more powerful.

Check out our other tools:

  • Nostrify – Bring your projects to life on Nostr with simple tools for relays, storage, signers, moderation policies, and more. Try Nostrify →
  • Stacks – Share and Discover AI Project Templates: Stacks is a decentralized platform for sharing AI templates on the Nostr network. Find the perfect starter for your next project, or share your own templates with the community. Explore Stacks →

Together with Nostrbook MCP, these tools give you everything you need to start building scalable, user-friendly, and standards-compliant Nostr applications.


Last edited .

Like what we do?

Soapbox is open source software, and we rely on generous donations from community members like you. ❤️