Registry Broker Skills

What is this?

This repository contains skill definitions for the Universal Agentic Registry — the connectivity layer for the autonomous web. Skills are instruction files that teach AI coding assistants how to interact with the Registry Broker API.

The SKILL.md file can be consumed by:

• Claude Code / Claude Desktop — via MCP or direct skill loading
• OpenAI Codex / ChatGPT — as context instructions
• Cursor — as project instructions
• OpenClaw / ClawHub — native skill format
• Any AI coding assistant — universal markdown format

What is the Universal Registry?

One standards-compliant API to access 72,000+ AI agents from:

Quick Start

Option 1: Use the Skill File

Copy SKILL.md to your project or reference it in your AI assistant's context.

Option 2: MCP Server (recommended for Claude/Cursor)

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

Option 3: TypeScript SDK

npm install @hashgraphonline/standards-sdk

import { RegistryBrokerClient } from "@hashgraphonline/standards-sdk";

const client = new RegistryBrokerClient();

// Search for AI agents
const results = await client.search({ q: "trading bot" });

// Chat with an agent
const session = await client.createChatSession({ uaid: "uaid:aid:..." });
const response = await client.sendMessage({ 
  sessionId: session.sessionId, 
  message: "Hello!" 
});

Option 4: Direct API (curl)

# Get API key at https://hol.org/registry
export REGISTRY_BROKER_API_KEY="your-key"

# Search for agents
curl "https://hol.org/registry/api/v1/search?q=trading+bot&limit=5"

# Create chat session
curl -X POST "https://hol.org/registry/api/v1/chat/session" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $REGISTRY_BROKER_API_KEY" \
  -d '{"uaid": "uaid:aid:..."}'

Repository Contents

registry-broker-skills/
├── SKILL.md              # Universal skill definition (main instruction file)
├── README.md             # This file
├── LICENSE               # Apache-2.0
├── scripts/              # Helper bash scripts
│   ├── search.sh         # Search for agents
│   ├── chat.sh           # Start a chat session
│   ├── resolve.sh        # Resolve UAID to details
│   ├── stats.sh          # Get platform statistics
│   └── balance.sh        # Check credit balance
├── examples/             # Code examples
│   ├── search-and-chat.js    # Search and chat workflow
│   ├── register-agent.js     # Agent registration
│   └── ledger-auth.js        # Wallet authentication
└── references/           # API documentation
    ├── API.md            # Complete API reference
    ├── PROTOCOLS.md      # Supported protocols
    └── MCP.md            # MCP server reference

Scripts

Quick bash scripts for common operations:

# Search for agents
./scripts/search.sh "trading bot" 5

# Resolve a UAID
./scripts/resolve.sh "uaid:aid:fetchai:agent123"

# Start a chat session (requires API key)
export REGISTRY_BROKER_API_KEY="your-key"
./scripts/chat.sh "uaid:aid:fetchai:agent123" "Hello!"

# Check platform stats
./scripts/stats.sh

# Check credit balance
./scripts/balance.sh

API Capabilities

Discovery

• Keyword Search — Find agents by name, description, capabilities
• Vector/Semantic Search — Natural language agent discovery
• Capability Search — Filter by specific agent capabilities
• Agent Details — Full profile, metadata, trust scores
• Similar Agents — Find related agents

Chat

• Create Session — Start conversation with any agent
• Send Messages — Real-time chat with streaming support
• History — Retrieve conversation history
• Compact — Summarize history for context window management

Registration

• Quote — Get credit cost estimate
• Register — Add your agent to the registry
• Update — Modify agent profile
• Unregister — Remove agent

Credits & Payments

• Balance — Check credit balance
• HBAR Payments — Purchase credits with HBAR
• Stripe Payments — Purchase credits with card
• X402 (EVM) — Purchase credits via EVM wallets

Authentication

• API Key — Traditional API key auth
• Ledger Auth — Wallet-based authentication (Hedera, Ethereum, Base, Polygon)

API & Documentation

Related Repositories

Using with AI Assistants

Claude Code / Claude Desktop

Add to your Claude configuration:

{
  "mcpServers": {
    "hashnet": {
      "command": "npx",
      "args": ["@hol-org/hashnet-mcp@latest", "up", "--transport", "stdio"]
    }
  }
}

Or reference SKILL.md directly in your conversation.

Cursor

Copy SKILL.md to your project root, or add to .cursor/rules/.

OpenClaw / ClawHub

The SKILL.md file uses OpenClaw's native YAML frontmatter format and is directly compatible.

Codex / ChatGPT

Reference the skill file in your system prompt or paste its contents as context.

Score HOL Points

Contribute to this repository and score HOL Points!

• Fix bugs or improve documentation
• Add new features or examples
• Submit pull requests to score points

Points can be used across the HOL ecosystem. Learn more

License

Apache-2.0