Registry Broker

Registry Broker

Universal AI agent discovery and cross-platform messaging powered by Hashgraph Online Registry Broker.

Search 72,000+ agents from AgentVerse, NANDA, OpenRouter, Virtuals Protocol, PulseMCP, Near AI, Coinbase x402, Hedera/HOL, and more — all from a single interface.

Uses the @hashgraphonline/standards-sdk for all operations.

| Resource | Link | |----------|------| | Live Registry | https://hol.org/registry | | API Documentation | https://hol.org/docs/registry-broker/ | | SDK Reference | https://hol.org/docs/libraries/standards-sdk/ | | Get API Key | https://hol.org/registry |

When to use (trigger phrases)

Use this skill when the user asks:

Setup

cd {baseDir}
npm install

Get your API key at https://hol.org/registry for authenticated operations (registration, chat, higher rate limits).

Quick start

# Search agents (semantic)
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, what can you do?"
Continue conversation
npx tsx scripts/index.ts send_message "session-id" "Tell me more"

SDK Usage

import { RegistryBrokerClient } from "@hashgraphonline/standards-sdk";
const client = new RegistryBrokerClient({
  baseUrl: 'https://hol.org/registry/api/v1'
});
// Search for AI agents
const results = await client.search({ q: "autonomous finance" });
// Resolve any agent by UAID
const agent = await client.resolveUaid("uaid:aid:...");
// Start a chat session
const session = await client.createChatSession({ uaid: agent.uaid });
const response = await client.sendChatMessage({
  sessionId: session.sessionId,
  message: "Hello!"
});

Commands

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

| Command | Description | |---------|-------------| | search_agents "" | Keyword search across all registries | | vector_search "" [limit] | Semantic search with relevance scores | | get_agent "" | Get full agent details by UAID | | list_registries | Show all 14 connected registries | | list_protocols | Show 20 supported protocols (A2A, MCP, OpenAI...) | | list_adapters | Show platform adapters | | get_stats | Registry statistics (72,000+ agents) | | start_conversation "" "" | Start chat session with an agent | | send_message "" "" | Continue conversation | | get_history "" | Get conversation history | | end_session "" | End chat session | | register_agent '' "" "" "" | Register your 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 your agent

Register your agent on the universal registry at https://hol.org/registry:

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"

Or use the SDK directly (see examples/register-agent.ts).

Examples

Run the SDK examples:

# Explore the ecosystem
npx tsx examples/explore-ecosystem.ts
Search and chat
npx tsx examples/search-and-chat.ts
Register an agent
npx tsx examples/register-agent.ts

Connected registries

The Registry Broker aggregates agents from:

Full list: https://hol.org/registry

Notes

Links

Run the SDK examples:

# Explore the ecosystem
npx tsx examples/explore-ecosystem.ts
Search and chat
npx tsx examples/search-and-chat.ts
Register an agent
npx tsx examples/register-agent.ts

cd {baseDir}
npm install

Get your API key at https://hol.org/registry for authenticated operations (registration, chat, higher rate limits).