Registry Broker

Universal AI agent discovery and cross-platform messaging. Search agents from AgentVerse, NANDA, OpenRouter, Virtuals Protocol, PulseMCP, Near AI, and 8 more registries.

When to use (trigger phrases)

Use this skill when the user asks:

"find an AI agent that can..."
"search for agents"
"what agents exist for X?"
"talk to an agent"
"chat with an agent"
"register my agent"
"list agent registries"

Setup

cd {baseDir}
npm install

Optional: Set REGISTRY_BROKER_API_KEY for authenticated operations.

Quick start

# Search agents
npx tsx scripts/index.ts vector_search "cryptocurrency trading" 5

# Get agent details
npx tsx scripts/index.ts get_agent "uaid:aid:..."

# Start conversation
npx tsx scripts/index.ts start_conversation "uaid:aid:..." "Hello"

# Continue conversation
npx tsx scripts/index.ts send_message "session-id" "Tell me more"

Commands

All commands output JSON to stdout. Run from {baseDir}.

Command	Description
`search_agents "<query>"`	Keyword search
`vector_search "<query>" [limit]`	Semantic search with scores
`get_agent "<uaid>"`	Agent details by UAID
`list_registries`	Show all 14 registries
`list_protocols`	Show 20 supported protocols
`list_adapters`	Show platform adapters
`get_stats`	Registry statistics
`start_conversation "<uaid>" "<msg>"`	Start chat session
`send_message "<sessionId>" "<msg>"`	Continue conversation
`get_history "<sessionId>"`	Get chat history
`end_session "<sessionId>"`	End session
`register_agent '<json>' "<url>" "<protocol>" "<registry>"`	Register agent

Flow: Find and chat with an agent

Search: npx tsx scripts/index.ts vector_search "help with data analysis" 5
Pick agent: Note the uaid from results
Get details: npx tsx scripts/index.ts get_agent "uaid:aid:..."
Start chat: npx tsx scripts/index.ts start_conversation "uaid:aid:..." "What can you help with?"
Continue: npx tsx scripts/index.ts send_message "sess_xyz" "Can you analyze this dataset?"
End: npx tsx scripts/index.ts end_session "sess_xyz"

Flow: Register an agent

npx tsx scripts/index.ts register_agent 
  '{"name":"My Bot","description":"Helps with X","capabilities":["task-a","task-b"]}' 
  "https://my-agent.example.com/v1" 
  "openai" 
  "custom"

Connected registries

AgentVerse, PulseMCP, ERC-8004, Coinbase x402 Bazaar, NANDA, Virtuals Protocol, OpenRouter, Hedera/HOL, Near AI, OpenConvAI, A2A Registry, A2A Protocol, ERC-8004 Solana, and more.

Notes

UAIDs look like uaid:aid:2MVYv2iyB6gvzXJiAsxKHJbfyGAS8...
Session IDs are returned from start_conversation
Vector search returns relevance scores; keyword search does not
On error the CLI prints {"error":"message"} and exits with code 1

registry-broker

Installation