Registry Broker Skills

HOL Registry

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

[](https://www.npmjs.com/package/@hol-org/registry) [](https://www.npmjs.com/package/@hashgraphonline/standards-sdk) [](https://doi.org/10.5281/zenodo.18748323) [](https://hol.org/registry) [](https://hol.org/registry/skills/registry-broker) [](https://app.getpostman.com/run-collection/51598040-f1ef77fd-ae05-4edb-8663-efa52b0d1e99?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D51598040-f1ef77fd-ae05-4edb-8663-efa52b0d1e99%26entityType%3Dcollection%26workspaceId%3Dfb06c3a9-4aab-4418-8435-cf73197beb57) [](https://insomnia.rest/run/?label=Universal%20Agentic%20Registry&uri=https%3A%2F%2Fhol.org%2Fregistry%2Fapi%2Fv1%2Fopenapi.json) [](https://hol.org/registry/api/v1/openapi.json) [](./schemas/skill.schema.json)

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.

It is designed for developer-intent discovery around:

• MCP server registry and MCP server discovery
• Agent skills registry and skill package publishing
• Agent directory CLI workflows and API-first integration

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

Share & Embed

Use these snippets in your README, docs, or release notes to link canonical skill surfaces:

[](https://hol.org/registry/skills)
[](https://github.com/hashgraph-online/skill-publish)

Direct references:

• Skills index: https://hol.org/registry/skills
• Product docs: https://hol.org/docs/registry-broker/
• Interactive API docs: https://hol.org/registry/docs
• OpenAPI schema: https://hol.org/registry/api/v1/openapi.json
• Live stats endpoint: https://hol.org/registry/api/v1/dashboard/stats
• Skill publishing action: https://github.com/hashgraph-online/skill-publish

Schema & Validation

• Canonical manifest schema: [schemas/skill.schema.json](./schemas/skill.schema.json)
• SchemaStore submission kit: [references/SCHEMASTORE-SUBMISSION.md](./references/SCHEMASTORE-SUBMISSION.md)
• Syndication kit: [references/SYNDICATION-KIT.md](./references/SYNDICATION-KIT.md)
• APIs metadata: [apis.json](./apis.json)
• LLM index: [llms.txt](./llms.txt)

DOI Readiness

• Zenodo metadata: [.zenodo.json](./.zenodo.json)
• Citation metadata: [CITATION.cff](./CITATION.cff)

What is the Universal Registry?

One standards-compliant API to access live AI agent inventory 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 init --dir ./my-skill --name "my-skill" --version 0.1.0
npx @hol-org/registry skills lint --dir ./my-skill
npx @hol-org/registry skills list --name "my-skill" --limit 5
npx @hol-org/registry skills verify --name "my-skill" --tier basic --account-id 0.0.1234
npx @hol-org/registry skills verification-status --name "my-skill" --account-id 0.0.1234
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  --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 + submission kits
│   ├── API.md            # Complete API reference
│   ├── PROTOCOLS.md      # Supported protocols
│   ├── MCP.md            # MCP server reference
│   ├── SCHEMASTORE-SUBMISSION.md
│   └── SYNDICATION-KIT.md
└── schemas/
    └── skill.schema.json # JSON Schema for skill.json

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 | | Interactive API Docs | hol.org/registry/docs | | SDK Documentation | hol.org/docs/libraries/standards-sdk | | Postman Collection | Run in Postman | | Insomnia | Import OpenAPI | | OpenAPI Spec | openapi.json | | Live Stats Endpoint | dashboard/stats |

Related Repositories

| Repository | Description | |------------|-------------| | hashnet-mcp-js | MCP server for Registry Broker | | standards-sdk | TypeScript/JavaScript SDK | | universal-registry-quickstart | Quickstart example project | | skill-publish | GitHub Action for quote/publish/poll skill release workflows |

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

Cite this repository

If you reference this project in documentation, reports, or research, use the metadata in [CITATION.cff](./CITATION.cff).

CI/CD: Publish from GitHub

This repository supports one-step HCS-26 publishing from GitHub using the first-party action hashgraph-online/skill-publish@v1.

• Workflow: .github/workflows/skills-publish.yml
• Triggered on release: published, push to main, and manual dispatch
• Automatically validates package files, gets quote, publishes, polls job status, and posts on-chain references back to release notes/PR comments
• Automatically stamps repo and commit metadata into the published skill payload

Required repository secret:

• RB_API_KEY

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hashgraph-online
• Source: hashgraph-online/registry-broker-skills
• License: Apache-2.0
• Homepage: https://hol.org/registry

Install and usage instructions live in the source repository linked above.