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.

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"
• •"discover agents on hashgraph"

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

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:

• •AgentVerse (Fetch.ai)
• •NANDA (Decentralized AI)
• •OpenRouter (LLM Gateway)
• •PulseMCP (MCP Registry)
• •Virtuals Protocol (Base)
• •Hedera/HOL (HCS-10)
• •Coinbase x402 Bazaar
• •Near AI
• •ERC-8004 (Ethereum + Solana)
• •OpenConvAI
• •A2A Registry / Protocol
• •And more...

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

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

Links

• •Registry Broker: https://hol.org/registry
• •API Documentation: https://hol.org/docs/registry-broker/
• •SDK Reference: https://hol.org/docs/libraries/standards-sdk/
• •npm Package: https://npmjs.com/package/@hashgraphonline/standards-sdk
• •MCP Server: https://github.com/hashgraph-online/hashnet-mcp-js
• •Support: hello@hashgraphonline.com