forgesworn avatar

Bray

forgesworn/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 tools

Public 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*secret

Nostr secret key (nsec, hex, or BIP-39 mnemonic)

NOSTR_RELAYS*

Comma-separated list of Nostr relay WebSocket URLs

NWC_URIsecret

Nostr 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.

npm CI licence TypeScript GitHub Sponsors

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:


View the full README on GitHub

Details

Repository
github.com/forgesworn/bray
Category
Media & Entertainment
Package
nostr-bray
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from forgesworn

Related Media & Entertainment MCP servers

View all
1hellovelop avatarLimelink Mcp Serverhellovelop/limelink-mcp-serverMCP server for Limelink dynamic links with deep linking, social previews, and UTM tracking0stars
2holiday-forever avatarHoliday Foreverholiday-forever/holiday-forever-2Interactive photo gallery widget for a single Airbnb listing with price, rating, and link.0stars
3www avatarAudioAlphaio.audioalpha.www/mcpFinancial podcast intelligence platform — sentiment, narrative, and asset signals from 100+ podcasts0stars
4acedatacloud avatarMcp Lumaacedatacloud/lumamcpMCP server for Luma Dream Machine AI video generation0stars
5adkit avatarMeta Ads MCP Server by AdKitadkit/meta-ads-mcpMeta Ads MCP server: run Facebook and Instagram campaigns, ad sets, ads and reports from AI.0stars
6adkit avatarX Ads MCP Server by AdKitadkit/x-ads-mcpX Ads (Twitter Ads) MCP server: run X campaigns, ad groups, ads and reports from AI.0stars