
Bray
A comprehensive Nostr integration that gives AI agents full protocol access across 238 tools spanning identity management, encrypted DMs, Lightning zaps, trust attestations, and social operations. Supports NIP-46 bunker auth for production use, with identity resolution that accepts names, NIP-05 addresses, npubs, or hex keys. The standout feature is dispatch, an encrypted AI-to-AI collaboration layer built on NIP-89 capability discovery that lets agents publish what they can do and route tasks to each other automatically. Also includes scheduled posting with immediate signing, Blossom file storage, and marketplace primitives. Reach for this when you need Claude or another AI to operate as a first-class Nostr participant rather than just observing the protocol.
- tools
- 52
- auth
- Secret needed
- transport
- STDIO
- env vars
- 3
- last updated
- Apr 7, 2026
Tools
52 toolsPublic tool metadata for what this MCP can expose to an agent.
whoami
No parameter schema in public metadata yet.
identity-switch
No parameter schema in public metadata yet.
social-post
No parameter schema in public metadata yet.
social-reply
No parameter schema in public metadata yet.
social-feed
No parameter schema in public metadata yet.
social-profile-get
No parameter schema in public metadata yet.
dm-send
No parameter schema in public metadata yet.
dm-read
No parameter schema in public metadata yet.
dm-conversation
No parameter schema in public metadata yet.
zap-balance
No parameter schema in public metadata yet.
relay-query
No parameter schema in public metadata yet.
signet-badge
No parameter schema in public metadata yet.
trust-score
No parameter schema in public metadata yet.
verify-person
No parameter schema in public metadata yet.
vault-read
No parameter schema in public metadata yet.
article-publish
No parameter schema in public metadata yet.
article-read
No parameter schema in public metadata yet.
article-list
No parameter schema in public metadata yet.
search-notes
No parameter schema in public metadata yet.
search-profiles
No parameter schema in public metadata yet.
hashtag-feed
No parameter schema in public metadata yet.
badge-create
No parameter schema in public metadata yet.
badge-award
No parameter schema in public metadata yet.
badge-accept
No parameter schema in public metadata yet.
badge-list
No parameter schema in public metadata yet.
community-create
No parameter schema in public metadata yet.
community-feed
No parameter schema in public metadata yet.
community-post
No parameter schema in public metadata yet.
community-approve
No parameter schema in public metadata yet.
community-list
No parameter schema in public metadata yet.
calendar-create
No parameter schema in public metadata yet.
calendar-read
No parameter schema in public metadata yet.
calendar-rsvp
No parameter schema in public metadata yet.
listing-create
No parameter schema in public metadata yet.
listing-read
No parameter schema in public metadata yet.
listing-search
No parameter schema in public metadata yet.
listing-close
No parameter schema in public metadata yet.
dispatch-send
No parameter schema in public metadata yet.
dispatch-check
No parameter schema in public metadata yet.
dispatch-reply
No parameter schema in public metadata yet.
dispatch-ack
No parameter schema in public metadata yet.
dispatch-status
No parameter schema in public metadata yet.
dispatch-cancel
No parameter schema in public metadata yet.
dispatch-refuse
No parameter schema in public metadata yet.
dispatch-failure
No parameter schema in public metadata yet.
dispatch-query
No parameter schema in public metadata yet.
dispatch-propose
No parameter schema in public metadata yet.
dispatch-capability-publish
No parameter schema in public metadata yet.
dispatch-capability-discover
No parameter schema in public metadata yet.
dispatch-capability-read
No parameter schema in public metadata yet.
search-actions
No parameter schema in public metadata yet.
execute-action
No parameter schema in public metadata yet.
Sponsors
Configuration
NOSTR_SECRET_KEY*secretNostr secret key (nsec, hex, or BIP-39 mnemonic)
NOSTR_RELAYS*Comma-separated list of Nostr relay WebSocket URLs
NWC_URIsecretNostr Wallet Connect URI for Lightning zaps
Readme
nostr-bray
Trust-aware Nostr MCP server, CLI and TypeScript SDK for AI and humans. 261 tools across 29 groups. Model-agnostic. Works with Claude, ChatGPT, Gemini, Cursor, Windsurf, or any MCP client.
Quick Start
Requires Node.js 24 or later.
Install globally or run via npx:
npm install -g nostr-bray
New to Nostr? Mint a key first -- this works before anything is configured and prints your npub plus a 24-word mnemonic (write it down; it is the key):
npx nostr-bray create
Add to your MCP client config:
Details
- Repository
- github.com/forgesworn/bray
- Category
- Media & Entertainment
- Package
nostr-bray- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active