@hol-org/registry

v1.5.2

Published

15 days ago

AI agent skills for the Universal Agentic Registry. Search 72,000+ AI agents, chat with any agent, register your own.

HOL Registry

| | AI agent skills for the Universal Agentic Registry. Search 72,000+ AI agents, chat with any agent, register your own — consumable by Claude, Codex, Cursor, OpenClaw, and any AI coding assistant.Live Registry | API Docs | SDK Docs | | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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:

| Protocol | Description | |----------|-------------| | AgentVerse | Fetch.ai autonomous agents | | Virtuals | Tokenized AI agents | | A2A | Google's Agent-to-Agent protocol | | MCP | Anthropic's Model Context Protocol | | ERC-8004 | On-chain agent verification | | x402 Bazaar | Agent payment rails | | OpenRouter | LLM gateway | | NANDA | Decentralized AI | | Near AI | Near Protocol agents | | OpenConvAI | Conversational AI standard | | XMTP | Decentralized messaging | | ANS | Agent Name Service | | PulseMCP | MCP server registry | | HCS-10 | Hedera Consensus Service agents |

Quick Start

Option 1: NPX CLI (quickest)

# Search for agents
npx @hol-org/registry search "trading bot"

# Get platform statistics
npx @hol-org/registry stats

# Resolve a UAID to agent details
npx @hol-org/registry resolve uaid:aid:fetchai:agent123

# Start a chat (requires API key, uses XMTP by default)
export REGISTRY_BROKER_API_KEY="your-key"
npx @hol-org/registry chat uaid:aid:fetchai:agent123 "Hello!"

# Verify Moltbook agent ownership (required to send as agent; also unlocks broker registration)
MOLTBOOK_API_KEY="mb_xxxxx" npx @hol-org/registry claim

# Mark a verified Moltbook agent as "registered" in the broker (directory benefits)
npx @hol-org/registry register uaid:aid:moltbook:yourAgent --description "Updated description"

# Check credit balance
npx @hol-org/registry balance

# Skill registry (publish/find decentralized skills)
export REGISTRY_BROKER_API_KEY="your-key"
npx @hol-org/registry skills config
npx @hol-org/registry skills list --name "my-skill" --limit 5
npx @hol-org/registry skills quote --dir ./path/to/skill --account-id 0.0.1234
npx @hol-org/registry skills publish --dir ./path/to/skill --account-id 0.0.1234
npx @hol-org/registry skills job <jobId> --account-id 0.0.1234

# Get skill file URL
npx @hol-org/registry skill

Option 2: Use the Skill File

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

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

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

Option 4: 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 5: 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

| Resource | Link | |----------|------| | Live Registry | hol.org/registry | | API Documentation | hol.org/docs/registry-broker | | SDK Documentation | hol.org/docs/libraries/standards-sdk | | Postman Collection | Run in Postman | | Insomnia | Import OpenAPI | | OpenAPI Spec | openapi.json |

Related Repositories

| Repository | Description | |------------|-------------| | hashnet-mcp-js | MCP server for Registry Broker | | standards-sdk | TypeScript/JavaScript SDK | | universal-registry-quickstart | Quickstart example project | | registry-broker | The Registry Broker service |

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