⚡ AI-Optimized Documentation

    Nostrbook

    Structured Nostr Knowledge for Humans & AI

    The central registry of well-structured, detailed documentation about all aspects of the Nostr protocol. Enhanced with clearer explanations, examples, and built specifically for AI integration.

    Perfect for AI Projects

    Now with Model Context Protocol (MCP) integration

    AI agents can directly access all Nostr documentation through function calls - no scraping or outdated training data. Includes custom NIPs from NostrHub for the latest protocol extensions.

    MCP Integration
    Custom NIPs
    Real-time Updates
    Always Up-to-date
    AI-Friendly Format
    Community Curated
    nostrbook.dev/nip-01

    NIP-01: Basic protocol flow

    Status: Final • Updated: 2024

    Event Structure

    {
      "id": "event_id",
      "pubkey": "author_pubkey",
      "created_at": timestamp,
      "kind": number,
      "tags": [...],
      "content": "...",
      "sig": "signature"
    }
    Protocol
    Events
    Core
    100+
    NIPs Documented
    500+
    Code Examples
    MCP
    AI Integration

    Beyond the Official NIPs Repository

    While the official NIPs repository defines the specifications, Nostrbook expands upon them with structured navigation, detailed examples, and consistent formatting optimized for both human understanding and AI consumption.

    Model Context Protocol (MCP)

    Direct integration with AI tools through MCP, allowing agents to access up-to-date Nostr documentation without relying on training data.

    Works with Goose AI
    VSCode Copilot support
    Function-based access

    Custom NIPs from NostrHub

    Access to custom NIPs and protocol extensions from NostrHub, ensuring you have the latest developments beyond the core protocol.

    Community extensions
    Experimental NIPs
    Real-time updates

    Searchable Knowledge Base

    Full-text search across all documentation with structured navigation and cross-references between related concepts.

    Full-text search
    Cross-references
    Structured navigation

    Enhanced Documentation

    Clearer explanations, detailed examples, and consistent formatting that makes the protocol easier to understand.

    Real-world examples
    Implementation guides
    Consistent formatting

    Programmatic Access

    Markdown endpoints and llms.txt conformance for easy integration with AI tools and programmatic access.

    Markdown endpoints
    llms.txt specification
    API access

    Always Up-to-Date

    Regularly maintained to reflect the latest developments in the Nostr ecosystem and protocol changes.

    Automated updates
    Latest protocol changes
    Community maintained

    Explore the Documentation

    Organized by category for easy navigation and learning.

    01

    Basic Protocol Flow

    Foundation of Nostr

    Core event structure, relay communication, and basic client behavior.

    02

    Contact List

    Following & Metadata

    How users follow others and manage their social graph on Nostr.

    04

    Encrypted Messages

    Private Communication

    End-to-end encrypted direct messages between Nostr users.

    Nostrbook MCP Integration

    Model Context Protocol for AI Tools

    The Nostr Model Context Protocol (MCP) integration allows AI tools and agents to directly access structured Nostr documentation programmatically, eliminating the need to scrape documentation or rely solely on training data.

    Available MCP Functions

    01
    read_nip(nip)- Fetch NIPs from official repository
    02
    read_kind(kind)- Get event kind documentation
    03
    read_tag(tag)- Access tag specifications
    04
    read_protocol(doc)- Get protocol documentation
    05
    read_nips_index()- List all NIPs, kinds, and tags

    Key Benefits

    Up-to-date information (not limited by training data cutoffs)
    Structured data in well-formatted markdown
    Direct access to official documentation
    Includes custom NIPs from NostrHub

    Installation Guide

    For Goose AI

    1. Run goose configure
    2. Choose "Add Extension"
    3. Choose "Command-line Extension"
    4. Enter "nostr" as the name
    5. Enter command: npx -y xjsr @nostrbook/mcp
    6. Enter "10" seconds timeout

    For VSCode Copilot

    Create .vscode/mcp.json:

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

    Other MCP Clients

    Use command: npx -y xjsr @nostrbook/mcp

    Ready to Use

    Once installed, your AI assistant can answer questions like "What is the structure of a Nostr Kind 1 event?" using live documentation from Nostrbook and NostrHub.

    Access Structured Nostr Knowledge Today

    Whether you're a developer, researcher, or AI system, Nostrbook provides the comprehensive Nostr documentation you need with cutting-edge AI integration.

    Free to Access
    AI-Optimized
    Custom NIPs Included