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
uaidfrom 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