nostr-bray

Trust-aware Nostr MCP for AI and humans. 238 tools across 27 groups. Model-agnostic. Works with Claude, ChatGPT, Gemini, Cursor, Windsurf, or any MCP client.

Quick Start

Install globally or run via npx:

npm install -g nostr-bray

Add to your MCP client config:

{
  "mcpServers": {
    "nostr": {
      "command": "npx",
      "args": ["nostr-bray"],
      "env": {
        "NOSTR_SECRET_KEY": "nsec1...",
        "NOSTR_RELAYS": "wss://relay.damus.io,wss://nos.lol"
      }
    }
  }
}

Then ask your AI to call whoami to verify it works.

For production use, prefer Heartwood or any NIP-46 bunker (your key never leaves your signing device):

{
  "mcpServers": {
    "nostr": {
      "command": "npx",
      "args": ["nostr-bray"],
      "env": {
        "BUNKER_URI": "bunker://...",
        "NOSTR_RELAYS": "wss://relay.damus.io,wss://nos.lol"
      }
    }
  }
}

Auth tiers (best to worst)

Tier	Method	Key exposure
Heartwood	Dedicated signing appliance (BUNKER_URI)	Key never leaves the signing device. Supports nsec-tree derivation, per-client permissions, and device-backed attestations.
Software bunker	Any NIP-46 bunker (BUNKER_URI)	Key held by a separate process. Never seen by bray.
ncryptsec	NIP-49 encrypted key (NOSTR_NCRYPTSEC)	Key encrypted at rest, decrypted in memory at startup.
Key file	File path (NOSTR_SECRET_KEY_FILE)	Key on disk, read once, env var deleted.
Env var	Inline secret (NOSTR_SECRET_KEY)	Key visible in process environment. Use only for development.

Tool Groups

Group	Tools	Key examples
Identity	16	whoami, identity-derive-persona, identity-switch, identity-prove, nip05-lookup
Social	15	social-post, social-reply, social-feed, contacts-follow, social-notifications
Direct Messages	4	dm-send, dm-read, dm-conversation
Trust	22	trust-attest, trust-ring-prove, trust-spoken-challenge, trust-attest-chain
Dispatch	13	dispatch-send, dispatch-check, dispatch-reply, dispatch-capability-discover
Relay	13	relay-query, relay-set, relay-discover, cast-spell, relay-health
Moderation	16	label-create, list-mute, list-bookmark, list-followset-create, moderation-filter
Marketplace	16	marketplace-discover, marketplace-call, listing-create, listing-search
Safety	14	canary-session-create, canary-group-create, canary-duress-signal, safety-activate
Blossom	10	blossom-upload, blossom-mirror, blossom-verify, blossom-repair
Privacy	10	privacy-commit, privacy-prove-range, privacy-prove-age, privacy-publish-proof
Zap	9	zap-send, zap-balance, zap-make-invoice, zap-decode
Vault	9	vault-create, vault-encrypt, vault-share, vault-rotate
Workflow	7	trust-score, verify-person, identity-setup, relay-health, feed-discover
Signet	7	signet-badge, signet-vouch, signet-credentials, signet-challenge
Communities	5	community-create, community-feed, community-post, community-approve
Badges	4	badge-create, badge-award, `badge-acc

... View full README on GitHub