de en es ja ko ru zh

nostr-bray

Name: nostr-bray
Author: forgesworn

by forgesworn

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

nostr-bray

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

npm licence TypeScript GitHub Sponsors

Quick Start

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:

{
  "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.

Related MCP server: nwc-mcp

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-accept`, `badge-list`
Groups (NIP-29)	20	`group-inspect`, `group-invite-create`, `group-forum-comment`, `group-delete`
Articles	3	`article-publish`, `article-read`, `article-list`
Calendar	3	`calendar-create`, `calendar-read`, `calendar-rsvp`
Wiki	3	`wiki-publish`, `wiki-read`, `wiki-list`
Search	3	`search-notes`, `search-profiles`, `hashtag-feed`
Scheduling	4	`post-schedule`, `post-queue-list`, `post-queue-cancel`, `publish-event`
Community NIPs	2	`nip-publish`, `nip-read`
Utility	20	`decode`, `validate-event`, `verify-event`, `nip44-encrypt`, `tombstone`
Sync (NIP-77)	1	`sync-plan` (pull/push are explicit CLI and SDK operations)
Handler	2	`handler-publish`, `handler-discover`
Catalog	2	`search-actions`, `execute-action`

Use search-actions to find tools by keyword, then execute-action to run them.

Protocol foundations: semantic event validation, NIP-77 reconciliation, and relay-scoped NIP-29 groups.

Dispatch: AI-to-AI Collaboration

Dispatch lets AI agents collaborate over encrypted Nostr DMs. Any MCP-capable client can send structured tasks to other agents and receive results back.

13 message types: send, check, reply, ack, status, cancel, refuse, failure, query, propose, capability-publish, capability-discover, capability-read.

NIP-89 capability discovery: Agents publish what they can do. Other agents discover capabilities by topic, then route tasks to the right collaborator automatically.

dispatch-send("alice", "think", "Analyse the trade-offs of NIP-44 vs NIP-04")
dispatch-check()                    → inbox with pending tasks
dispatch-reply(taskId, result)      → send results back encrypted

All messages are NIP-44 encrypted. Recipients are resolved by name, NIP-05, npub, or hex.

Identity Resolver

Every tool that accepts a recipient uses universal identity resolution. You never need to look up hex pubkeys manually.

Accepted formats:

Name -- "alice" (resolved from your dispatch contacts)
NIP-05 -- "alice@example.com" (HTTP lookup)
npub -- "npub1abc..." (NIP-19 decode)
Hex -- "a1b2c3..." (64-character passthrough)

Scheduled Posting

Sign events now, publish later. Events are signed immediately with your current key, then held in a queue until the scheduled time.

post-schedule("Good morning!", "2026-04-01T08:00:00Z")
post-queue-list()          → view pending scheduled posts
post-queue-cancel(id)      → cancel before it publishes

NIP Coverage

nostr-bray implements or integrates the following NIPs:

NIP	What
NIP-01	Events, signing, relay protocol
NIP-02	Follow lists
NIP-05	DNS identity (lookup, verify, relay hints)
NIP-09	Event deletion
NIP-11	Relay information
NIP-17	Private DMs (gift wrap, default)
NIP-19	bech32 encoding (npub, nsec, nprofile, nevent, naddr)
NIP-23	Long-form articles (kind 30023)
NIP-22	Schema-correct comments for group forums
NIP-29	Relay-scoped groups, chat, forums, invitations and administration
NIP-32	Labels
NIP-40	Expiration tags
NIP-42	Relay auth
NIP-44	Encrypted payloads v2
NIP-45	Event counts
NIP-46	Nostr Connect (bunker)
NIP-49	Private key encryption (ncryptsec)
NIP-50	Search
NIP-51	Lists (mute, pin, follow sets, bookmarks)
NIP-52	Calendar events
NIP-54	Wiki pages
NIP-57	Lightning zaps
NIP-58	Badges
NIP-65	Relay list metadata
NIP-72	Communities
NIP-77	Negentropy ID reconciliation with truthful REQ fallback
NIP-78	Application-specific data
NIP-85	Trust rankings
NIP-89	Recommended applications (dispatch capability discovery)
NIP-96	HTTP file storage (Blossom)
NIP-99	Classified listings
NIP-A7	Spells (kind 777 — cast saved queries)
NIP-VA	Verifiable attestations (kind 31000)

Configuration

Config file (recommended)

Create ~/.config/bray/config.json (or ~/.nostr/bray.json):

{
  "bunkerUriFile": "/Users/you/.nostr/bunker-uri",
  "relays": ["wss://relay.damus.io", "wss://nos.lol"],
  "trustMode": "annotate"
}

Secrets are referenced by file path (bunkerUriFile, secretKeyFile, nwcUriFile) so they never appear in the config itself.

Search order: BRAY_CONFIG env var > $XDG_CONFIG_HOME/bray/config.json > ~/.nostr/bray.json.

Environment variables

Variable	Description
`BRAY_CONFIG`	Path to config file
`BUNKER_URI`	NIP-46 bunker URL (safest)
`BUNKER_URI_FILE`	Path to bunker URI file
`NOSTR_SECRET_KEY`	nsec, hex, or BIP-39 mnemonic
`NOSTR_SECRET_KEY_FILE`	Path to secret key file
`NOSTR_NCRYPTSEC`	NIP-49 encrypted key
`NOSTR_NCRYPTSEC_PASSWORD`	Password for ncryptsec
`NOSTR_RELAYS`	Comma-separated relay URLs
`TOR_PROXY`	SOCKS5h proxy for Tor
`NIP04_ENABLED`	Set `1` to enable legacy NIP-04 DMs
`TRANSPORT`	`stdio` (default) or `http`
`PORT`	HTTP port (default 3000)

All secret env vars are deleted from process.env immediately after parsing.

CLI

npx nostr-bray whoami                    # show your npub
npx nostr-bray post "hello from bray!"   # publish a note
npx nostr-bray persona work              # derive a work persona
npx nostr-bray prove blind               # create a linkage proof
npx nostr-bray --help                    # see all commands

Documentation

Usage Guide -- walkthroughs for identity, DMs, attestations, payments, and duress
Examples -- MCP config files and CLI workflow scripts
Contributing -- setup, architecture, testing, and conventions

For AI Assistants

See llms.txt for a concise summary optimised for AI context windows, or llms-full.txt for complete tool documentation with parameter details.

Part of the ForgeSworn Toolkit

ForgeSworn builds open-source cryptographic identity, payments, and coordination tools for Nostr.

Library	What it does
nsec-tree	Deterministic sub-identity derivation
ring-sig	SAG/LSAG ring signatures on secp256k1
range-proof	Pedersen commitment range proofs
canary-kit	Coercion-resistant spoken verification
spoken-token	Human-speakable verification tokens
toll-booth	L402 payment middleware
geohash-kit	Geohash toolkit with polygon coverage
nostr-attestations	NIP-VA verifiable attestations
dominion	Epoch-based encrypted access control
nostr-veil	Privacy-preserving Web of Trust

Licence

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

<1hResponse time

1dRelease cycle

73Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

SatRank
Blockchain Cryptocurrency Finance
proofoftrust21
A
license
-
quality
C
maintenance
Lightning Network trust oracle for AI agents. Provides real-time node reachability checks, trust scores, and personalized pathfinding for 17,000+ Lightning nodes via 12 MCP tools.
Last updated 2026-07-13
4
AGPL 3.0
nwc-mcp
Cryptocurrency Payments & Billing
llmops-pro
A
license
A
quality
B
maintenance
MCP server exposing a Lightning wallet to LLM agents over Nostr Wallet Connect (NIP-47): balance, invoices, LN address/LNURL payments, batch pay, and keysend. All spend tools are wrapped in a defense-in-depth safety stack — budget caps, allowlist, two-step confirmation, audit log.
Last updated 2026-06-15
13
30
MIT
nostr-read-mcp
Social Media Search Web3 & Decentralized Tech
rpriven
A
license
-
quality
C
maintenance
A read-only MCP server for AI agents to access Nostr profiles, notes, search, and relay lists through user-chosen relays, without requiring an account or keys.
Last updated 2026-06-28
MIT
Nvoy
Security Autonomous Agents
JAFairweather
A
license
-
quality
C
maintenance
Scoped, revocable data delegation to agentic workflows over nostr, mounted as an MCP server.
Last updated 2026-07-31
MIT

View all related MCP servers

Related MCP Connectors

Agentry — The Trust Layer for the Agent Economy
Agent registry with Nostr identity, reputation, escrow, observability, and Lightning payments.
Reasoning Commons
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
SaSame MCP Observatory + Gold Rush Town
No-key MCP: audit/certify MCPs, signed trust history; join Gold Rush Town & build with your LLM.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/forgesworn/bray'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

nostr-bray

Quick Start

Auth tiers (best to worst)

Tool Groups

Dispatch: AI-to-AI Collaboration

Identity Resolver

Scheduled Posting

NIP Coverage

Configuration

Config file (recommended)

Environment variables

CLI

Documentation

For AI Assistants

Part of the ForgeSworn Toolkit

Licence

Maintenance

Resources

Looking for Admin?

Related MCP Servers

SatRank

nwc-mcp

nostr-read-mcp

Nvoy

Related MCP Connectors

Latest Blog Posts

MCP directory API