de en es ja ko ru zh

nostr-bray

Name: nostr-bray
Author: forgesworn

by forgesworn

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

nostr-bray

MCP de Nostr con reconocimiento de confianza para IA y humanos. 238 herramientas en 27 grupos. Agnóstico al modelo. Funciona con Claude, ChatGPT, Gemini, Cursor, Windsurf o cualquier cliente MCP.

npm licence TypeScript GitHub Sponsors

Inicio rápido

Instala globalmente o ejecuta mediante npx:

npm install -g nostr-bray

Añade a la configuración de tu cliente MCP:

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

Luego pídele a tu IA que ejecute whoami para verificar que funciona.

Para uso en producción, prefiere Heartwood o cualquier bunker NIP-46 (tu clave nunca abandona tu dispositivo de firma):

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

Niveles de autenticación (del mejor al peor)

Nivel	Método	Exposición de clave
Heartwood	Dispositivo de firma dedicado (`BUNKER_URI`)	La clave nunca abandona el dispositivo de firma. Soporta derivación nsec-tree, permisos por cliente y atestaciones respaldadas por dispositivo.
Software bunker	Cualquier bunker NIP-46 (`BUNKER_URI`)	Clave mantenida por un proceso separado. Nunca vista por bray.
ncryptsec	Clave cifrada NIP-49 (`NOSTR_NCRYPTSEC`)	Clave cifrada en reposo, descifrada en memoria al iniciar.
Archivo de clave	Ruta de archivo (`NOSTR_SECRET_KEY_FILE`)	Clave en disco, leída una vez, variable de entorno eliminada.
Variable de entorno	Secreto en línea (`NOSTR_SECRET_KEY`)	Clave visible en el entorno del proceso. Usar solo para desarrollo.

Related MCP server: nwc-mcp

Grupos de herramientas

Grupo	Herramientas	Ejemplos clave
Identidad	16	`whoami`, `identity-derive-persona`, `identity-switch`, `identity-prove`, `nip05-lookup`
Social	15	`social-post`, `social-reply`, `social-feed`, `contacts-follow`, `social-notifications`
Mensajes directos	4	`dm-send`, `dm-read`, `dm-conversation`
Confianza	22	`trust-attest`, `trust-ring-prove`, `trust-spoken-challenge`, `trust-attest-chain`
Despacho	13	`dispatch-send`, `dispatch-check`, `dispatch-reply`, `dispatch-capability-discover`
Relay	13	`relay-query`, `relay-set`, `relay-discover`, `cast-spell`, `relay-health`
Moderación	16	`label-create`, `list-mute`, `list-bookmark`, `list-followset-create`, `moderation-filter`
Mercado	16	`marketplace-discover`, `marketplace-call`, `listing-create`, `listing-search`
Seguridad	14	`canary-session-create`, `canary-group-create`, `canary-duress-signal`, `safety-activate`
Blossom	10	`blossom-upload`, `blossom-mirror`, `blossom-verify`, `blossom-repair`
Privacidad	10	`privacy-commit`, `privacy-prove-range`, `privacy-prove-age`, `privacy-publish-proof`
Zap	9	`zap-send`, `zap-balance`, `zap-make-invoice`, `zap-decode`
Bóveda	9	`vault-create`, `vault-encrypt`, `vault-share`, `vault-rotate`
Flujo de trabajo	7	`trust-score`, `verify-person`, `identity-setup`, `relay-health`, `feed-discover`
Signet	7	`signet-badge`, `signet-vouch`, `signet-credentials`, `signet-challenge`
Comunidades	5	`community-create`, `community-feed`, `community-post`, `community-approve`
Insignias	4	`badge-create`, `badge-award`, `badge-accept`, `badge-list`
Grupos (NIP-29)	4	`group-info`, `group-chat`, `group-send`, `group-members`
Artículos	3	`article-publish`, `article-read`, `article-list`
Calendario	3	`calendar-create`, `calendar-read`, `calendar-rsvp`
Wiki	3	`wiki-publish`, `wiki-read`, `wiki-list`
Búsqueda	3	`search-notes`, `search-profiles`, `hashtag-feed`
Programación	4	`post-schedule`, `post-queue-list`, `post-queue-cancel`, `publish-event`
NIPs de comunidad	2	`nip-publish`, `nip-read`
Utilidad	19	`decode`, `encode-npub`, `nip44-encrypt`, `verify-event`, `tombstone`
Manejador	2	`handler-publish`, `handler-discover`
Catálogo	2	`search-actions`, `execute-action`

Usa search-actions para encontrar herramientas por palabra clave, luego execute-action para ejecutarlas.

Despacho: Colaboración IA a IA

El despacho permite que los agentes de IA colaboren a través de mensajes directos cifrados de Nostr. Cualquier cliente compatible con MCP puede enviar tareas estructuradas a otros agentes y recibir resultados.

13 tipos de mensajes: send, check, reply, ack, status, cancel, refuse, failure, query, propose, capability-publish, capability-discover, capability-read.

Descubrimiento de capacidades NIP-89: Los agentes publican lo que pueden hacer. Otros agentes descubren capacidades por tema y luego enrutan las tareas al colaborador adecuado automáticamente.

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

Todos los mensajes están cifrados con NIP-44. Los destinatarios se resuelven por nombre, NIP-05, npub o hex.

Resolución de identidad

Cada herramienta que acepta un destinatario utiliza resolución de identidad universal. Nunca necesitas buscar claves públicas hex manualmente.

Formatos aceptados:

Nombre -- "alice" (resuelto desde tus contactos de despacho)
NIP-05 -- "alice@example.com" (búsqueda HTTP)
npub -- "npub1abc..." (decodificación NIP-19)
Hex -- "a1b2c3..." (paso directo de 64 caracteres)

Publicación programada

Firma eventos ahora, publica después. Los eventos se firman inmediatamente con tu clave actual y luego se mantienen en una cola hasta la hora programada.

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

Cobertura de NIPs

nostr-bray implementa o integra los siguientes NIPs:

NIP	Qué es
NIP-01	Eventos, firma, protocolo de relay
NIP-02	Listas de seguimiento
NIP-05	Identidad DNS (búsqueda, verificación, sugerencias de relay)
NIP-09	Eliminación de eventos
NIP-11	Información de relay
NIP-17	Mensajes directos privados (gift wrap, predeterminado)
NIP-19	Codificación bech32 (npub, nsec, nprofile, nevent, naddr)
NIP-23	Artículos de formato largo (kind 30023)
NIP-29	Chat grupal
NIP-32	Etiquetas
NIP-40	Etiquetas de expiración
NIP-42	Autenticación de relay
NIP-44	Cargas útiles cifradas v2
NIP-45	Conteos de eventos
NIP-46	Nostr Connect (bunker)
NIP-49	Cifrado de clave privada (ncryptsec)
NIP-50	Búsqueda
NIP-51	Listas (silenciar, fijar, conjuntos de seguimiento, marcadores)
NIP-52	Eventos de calendario
NIP-54	Páginas Wiki
NIP-57	Zaps de Lightning
NIP-58	Insignias
NIP-65	Metadatos de lista de relays
NIP-72	Comunidades
NIP-78	Datos específicos de la aplicación
NIP-85	Rankings de confianza
NIP-89	Aplicaciones recomendadas (descubrimiento de capacidades de despacho)
NIP-96	Almacenamiento de archivos HTTP (Blossom)
NIP-99	Listados clasificados
NIP-A7	Hechizos (kind 777 — ejecutar consultas guardadas)
NIP-VA	Atestaciones verificables (kind 31000)

Configuración

Archivo de configuración (recomendado)

Crea ~/.config/bray/config.json (o ~/.nostr/bray.json):

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

Los secretos se referencian por ruta de archivo (bunkerUriFile, secretKeyFile, nwcUriFile) para que nunca aparezcan en la configuración misma.

Orden de búsqueda: variable de entorno BRAY_CONFIG > $XDG_CONFIG_HOME/bray/config.json > ~/.nostr/bray.json.

Variables de entorno

Variable	Descripción
`BRAY_CONFIG`	Ruta al archivo de configuración
`BUNKER_URI`	URL del bunker NIP-46 (más seguro)
`BUNKER_URI_FILE`	Ruta al archivo de URI del bunker
`NOSTR_SECRET_KEY`	nsec, hex o mnemónico BIP-39
`NOSTR_SECRET_KEY_FILE`	Ruta al archivo de clave secreta
`NOSTR_NCRYPTSEC`	Clave cifrada NIP-49
`NOSTR_NCRYPTSEC_PASSWORD`	Contraseña para ncryptsec
`NOSTR_RELAYS`	URLs de relays separadas por comas
`TOR_PROXY`	Proxy SOCKS5h para Tor
`NIP04_ENABLED`	Establecer `1` para habilitar mensajes directos NIP-04 heredados
`TRANSPORT`	`stdio` (predeterminado) o `http`
`PORT`	Puerto HTTP (predeterminado 3000)

Todas las variables de entorno secretas se eliminan de process.env inmediatamente después de ser analizadas.

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

Documentación

Guía de uso -- tutoriales para identidad, mensajes directos, atestaciones, pagos y coacción
Ejemplos -- archivos de configuración MCP y scripts de flujo de trabajo CLI
Contribución -- configuración, arquitectura, pruebas y convenciones

Para asistentes de IA

Consulta llms.txt para un resumen conciso optimizado para ventanas de contexto de IA, o llms-full.txt para la documentación completa de herramientas con detalles de parámetros.

Parte del kit de herramientas ForgeSworn

ForgeSworn construye herramientas de identidad criptográfica, pagos y coordinación de código abierto para Nostr.

Biblioteca	Qué hace
nsec-tree	Derivación determinista de sub-identidad
ring-sig	Firmas de anillo SAG/LSAG en secp256k1
range-proof	Pruebas de rango de compromiso de Pedersen
canary-kit	Verificación hablada resistente a la coacción
spoken-token	Tokens de verificación pronunciables por humanos
toll-booth	Middleware de pago L402
geohash-kit	Kit de herramientas Geohash con cobertura de polígonos
nostr-attestations	Atestaciones verificables NIP-VA
dominion	Control de acceso cifrado basado en épocas
nostr-veil	Web de confianza que preserva la privacidad

Licencia

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive

ResponsivenessResponsive

Resources

Need Help?

Related Servers

Related MCP Connectors

Agentry — The Trust Layer for the Agent Economy B
io.github.cthulhutoo
Agent registry with Nostr identity, reputation, escrow, observability, and Lightning payments.
Agent Orchestration Autonomous Agents Blockchain
362
Dominion Observatory
com.dominionobservatory
Trust checks for MCP servers: trust scores, tool-drift detection, signed diligence receipts. Free.
Security Observability
2
bitcoin-stratigraphy A
app.replit.bitcoin-stratigraphy-dashboard--charlesstrogish
Enterprise L402 data vending engine delivering real-time thermodynamic Bitcoin telemetry, Groth16 ZK-SNARK verification, Nostr P2P mesh consensus, and agent context grounding to autonomous AI swarms.
Blockchain Cryptocurrency Finance
151
Reasoning Commons
io.github.chenyuan35
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
AI & Machine Learning Knowledge & Memory Autonomous Agents
2

Related MCP Servers

SatRank
Blockchain Cryptocurrency Finance
proofoftrust21
A
license
Not graded
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.
Updated 3 months ago (2026-07-13 07:45 UTC)
3 npm
AGPL 3.0
nwc-mcp
Cryptocurrency Payments & Billing
llmops-pro
A
license
A
quality
D
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.
Updated 4 months ago (2026-06-15 09:57 UTC)
13
35 npm
MIT
nostr-read-mcp
Social Media Search Web3 & Decentralized Tech
rpriven
A
license
Not graded
quality
D
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.
Updated 3 months ago (2026-06-28 04:38 UTC)
MIT
Nvoy
Security Autonomous Agents
JAFairweather
A
license
Not graded
quality
A
maintenance
Scoped, revocable data delegation to agentic workflows over nostr, mounted as an MCP server.
Updated 8 days ago (2026-09-26 21:54 UTC)
MIT

nostr-bray

Inicio rápido

Niveles de autenticación (del mejor al peor)

Grupos de herramientas

Despacho: Colaboración IA a IA

Resolución de identidad

Publicación programada

Cobertura de NIPs

Configuración

Archivo de configuración (recomendado)

Variables de entorno

CLI

Documentación

Para asistentes de IA

Parte del kit de herramientas ForgeSworn

Licencia

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

SatRank

nwc-mcp

nostr-read-mcp

Nvoy