registry-broker

# 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

```bash
cd {baseDir}
npm install
```

Optional: Set `REGISTRY_BROKER_API_KEY` for authenticated operations.

## Quick start

```bash
# 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

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

## Flow: Register an agent

```bash
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