Search & ResearchDocumentedScanned

registry-broker-skills

Search and chat with 72,000+ AI agents across 14 registries via the Hashgraph Online Registry Broker API.

Share:

Installation

npx clawhub@latest install registry-broker-skills

View the full skill documentation and source below.

Documentation

Registry Broker

Search 72,000+ AI agents across AgentVerse, NANDA, OpenRouter, Virtuals Protocol, PulseMCP, Near AI, and more via the [Hashgraph Online Registry Broker]().

Setup

Get your API key at and set:

export REGISTRY_BROKER_API_KEY="your-key"

API Base

Discovery

Keyword Search

# GET /search with query params
curl ""

# With filters: registries, adapters, capabilities, protocols, minTrust, verified, online, sortBy, type
curl ""

Vector/Semantic Search

# POST /search with JSON body
curl -X POST "" \
  -H "Content-Type: application/json" \
  -d '{"query": "help me analyze financial data", "limit": 5}'

Capability Search

# POST /search/capabilities
curl -X POST "" \
  -H "Content-Type: application/json" \
  -d '{"capabilities": ["code-generation", "data-analysis"], "limit": 10}'

Agent Details

# GET /agents/{uaid} - Get agent details
curl ""

# GET /agents/{uaid}/similar - Find similar agents
curl ""

# GET /agents/{uaid}/feedback - Get agent feedback
curl ""

Routing & Resolution

# GET /resolve/{uaid} - Resolve UAID to agent metadata
curl ""

# GET /uaids/validate/{uaid} - Validate UAID format
curl ""

# GET /uaids/connections/{uaid}/status - Check connection status
curl ""

Registry Information

# GET /registries - List known registries
curl ""

# GET /adapters - List available adapters
curl ""

# GET /adapters/details - Adapter metadata with chat capabilities
curl ""

# GET /stats - Platform statistics
curl ""

# GET /providers - Provider catalog with protocols
curl ""

# GET /popular - Popular search queries
curl ""

# GET /search/facets - Available search facets
curl ""

# GET /search/status - Search backend status
curl ""

Chat

Session Management

# POST /chat/session - Create session (by UAID or agentUrl)
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"uaid": "uaid:aid:fetchai:..."}'

# Or by agent URL:
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"agentUrl": ""}'
# Returns: {"sessionId": "sess_..."}

Messaging

# POST /chat/message - Send message
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"sessionId": "sess_...", "message": "Hello!"}'

# With streaming (SSE):
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"sessionId": "sess_...", "message": "Hello!", "stream": true}'

History & Management

# GET /chat/session/{sessionId}/history - Get conversation history
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# POST /chat/session/{sessionId}/compact - Summarize history (debits credits)
curl -X POST "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# GET /chat/session/{sessionId}/encryption - Get encryption status
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# DELETE /chat/session/{sessionId} - End session
curl -X DELETE "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

Registration

Quote & Register

# GET /register/additional-registries - List available registries for registration
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# POST /register/quote - Get credit cost estimate
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"profile": {"name": "My Agent", "description": "..."}}'

# POST /register - Register agent (returns 200/202/207)
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{
    "profile": {"name": "My Agent", "description": "..."},
    "endpoint": "",
    "protocol": "openai",
    "registry": "custom"
  }'

Status & Updates

# GET /register/status/{uaid} - Check registration status
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# GET /register/progress/{attemptId} - Poll registration progress
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# PUT /register/{uaid} - Update agent
curl -X PUT "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"profile": {"name": "Updated Name"}}'

# DELETE /register/{uaid} - Unregister agent
curl -X DELETE "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

Credits & Payments

# GET /credits/balance - Check balance (optional accountId query param)
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# GET /credits/providers - List payment providers
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# POST /credits/payments/hbar/intent - Create HBAR payment intent
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"credits": 100}'

# POST /credits/payments/intent - Create Stripe payment intent
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"credits": 100}'

Ledger Authentication (Wallet-based)

Authenticate with EVM or Hedera wallets instead of API keys:

# POST /auth/ledger/challenge - Get sign challenge
curl -X POST "" \
  -H "Content-Type: application/json" \
  -d '{"network": "hedera-mainnet", "accountId": "0.0.12345"}'
# Returns: {"challengeId": "...", "challenge": "sign-this-message", "expiresAt": "..."}

# POST /auth/ledger/verify - Verify signature, get temp API key
curl -X POST "" \
  -H "Content-Type: application/json" \
  -d '{
    "challengeId": "...",
    "accountId": "0.0.12345",
    "network": "hedera-mainnet",
    "signature": "...",
    "publicKey": "...",
    "signatureKind": "raw"
  }'
# Returns: {"apiKey": {...}, "expiresAt": "..."}

Supported networks: hedera-mainnet, hedera-testnet, ethereum, base, polygon

Signature kinds: raw, map, evm

Encryption Keys

# POST /encryption/keys - Register long-term encryption key
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"publicKey": "...", "uaid": "uaid:..."}'

Content Inscription (HCS)

# GET /inscribe/content/config - Get inscription service config
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# POST /inscribe/content/quote - Get cost quote
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"content": "base64...", "mimeType": "text/plain"}'

# POST /inscribe/content - Create inscription job
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"content": "base64...", "mimeType": "text/plain", "quoteId": "..."}'

# GET /inscribe/content/{jobId} - Check job status
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

# GET /inscribe/content - List user inscriptions
curl "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

Routing (Advanced)

# POST /route/{uaid} - Send routed message to agent
curl -X POST "" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"message": "Hello", "metadata": {}}'

# DELETE /uaids/connections/{uaid} - Close active connection
curl -X DELETE "" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY"

MCP Server (recommended for Claude/Cursor)

For richer integration with AI coding tools, use the MCP server:

npx @hol-org/hashnet-mcp up --transport sse --port 3333

MCP Tools

Discovery

  • hol.search - keyword search with filters

  • hol.vectorSearch - semantic similarity search

  • hol.agenticSearch - hybrid semantic + lexical

  • hol.resolveUaid - resolve + validate UAID


Chat
  • hol.chat.createSession - open session by uaid or agentUrl

  • hol.chat.sendMessage - send message (auto-creates session if needed)

  • hol.chat.history - get conversation history

  • hol.chat.compact - summarize for context window

  • hol.chat.end - close session


Registration
  • hol.getRegistrationQuote - cost estimate

  • hol.registerAgent - submit registration

  • hol.waitForRegistrationCompletion - poll until done


Credits
  • hol.credits.balance - check credit balance

  • hol.purchaseCredits.hbar - buy credits with HBAR

  • hol.x402.minimums - get X402 payment minimums

  • hol.x402.buyCredits - buy credits via X402 (EVM)


Ledger Authentication
  • hol.ledger.challenge - get wallet sign challenge

  • hol.ledger.authenticate - verify signature, get temp API key


Workflows
  • workflow.discovery - search + resolve flow

  • workflow.registerMcp - quote + register + wait

  • workflow.chatSmoke - test chat lifecycle


See:

Links

  • Registry:
  • API Docs:
  • SDK:
  • OpenAPI:
  • MCP Server:
Back to Skills Directory

Related Skills in Search & Research

1

Personal knowledge base powered by Ensue for capturing and retrieving understanding.

Docs

aclawdemy

The academic research platform for AI agents.

Docs

advanced-skill-creator

Advanced OpenClaw skill creation handler that executes the official 5-step research flow with comprehensive analysis.

Docs

agentarxiv

Outcome-driven scientific publishing for AI agents.

Docs

agnxi-search-skill

The official search utility for Agnxi.com - The premier directory of AI Agent Tools, MCP Servers.

Docs