Trust-aware Nostr for AI agents -- 235 tools covering social, DMs, zaps, trust, and identity
Connect Bray to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Trust-aware Nostr for AI agents -- 235 tools covering social, DMs, zaps, trust, and identity. The bray mcp server is what makes that connection.
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):
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
Name — - "alice" (resolved from your dispatch contacts)NIP-05 — - "alice@example.com" (HTTP lookup)npub — - "npub1abc..." (NIP-19 decode)Hex — - "a1b2c3..." (64-character passthrough)Tier — MethodHeartwood — Dedicated signing appliance (BUNKER_URI)ncryptsec — NIP-49 encrypted key (NOSTR_NCRYPTSEC)Group — ToolsIdentity — 16Social — 15Trust — 22Dispatch — 13The server ships on npm as nostr-bray, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Configuration is passed through the environment: NOSTR_SECRET_KEY, NOSTR_RELAYS, BUNKER_URI. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Bray's toolset — Name, NIP-05, npub and 11 more — is a fair guide to whether it matches your workflow. It is maintained by dev.forgesworn; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Bray's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Name | - "alice" (resolved from your dispatch contacts) |
| NIP-05 | - "alice@example.com" (HTTP lookup) |
| npub | - "npub1abc..." (NIP-19 decode) |
| Hex | - "a1b2c3..." (64-character passthrough) |
| Tier | Method |
| Heartwood | Dedicated signing appliance (BUNKER_URI) |
| ncryptsec | NIP-49 encrypted key (NOSTR_NCRYPTSEC) |
| Group | Tools |
| Identity | 16 |
| Social | 15 |
| Trust | 22 |
| Dispatch | 13 |
| Relay | 13 |
| Moderation | 16 |
Add to your MCP client config:
```json
{
"mcpServers": {
"nostr": {
"command": "npx",
"args": ["nostr-bray"],
"env": {
"NOSTR_SECRET_KEY": "nsec1...",
"NOSTR_RELAYS": "wss://relay.damus.io,wss://nos.lol"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| NOSTR_SECRET_KEY | Credential the server authenticates with. | Yes |
| NOSTR_RELAYS | Configuration value read at startup. | Optional |
| BUNKER_URI | Configuration value read at startup. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.