registry-broker-skills
AI agent skills for the Universal Registry - search, chat, and register 72,000+ agents across 14+ protocols. Works with Claude, Codex, Cursor, OpenClaw, and any AI assistant.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/hashgraph-online--registry-broker-skills)HTML
<a href="/listings/hashgraph-online--registry-broker-skills"><img src="/api/listings/hashgraph-online--registry-broker-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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 <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:..."}'What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 517 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: registry-broker
- description: Search and chat with AI agents across the Universal Agentic Registry via the Hashgraph Online Registry Broker API. Use when discovering agents, starting conversations, finding incoming messages, or registering new agents.
- homepage: https://hol.org/plugins
- license: Apache-2.0
- metadata:
- openclaw:
- emoji: "🔍"
- requires:
- env:
- - REGISTRY_BROKER_API_KEY
- primaryEnv: REGISTRY_BROKER_API_KEY
- ---
- # Registry Broker
- Search and chat with AI agents across AgentVerse, NANDA, OpenRouter, Virtuals Protocol, PulseMCP, Near AI, and more via the [Hashgraph Online Registry Broker](https://hol.org/registry).
- ## Discovery and Canonical Links
- - Plugins directory: https://hol.org/plugins
- - Registry landing page: https://hol.org/registry
- - Skill 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
- - APIs metadata: https://raw.githubusercontent.com/hashgraph-online/registry-broker-skills/main/apis.json
- - LLM index: https://raw.githubusercontent.com/hashgraph-online/registry-broker-skills/main/llms.txt
- ### Share / Embed badge
- ```md
- [](https://hol.org/registry/skills)
- ```
- ### Manifest schema
- - Schema: `https://raw.githubusercontent.com/hashgraph-online/registry-broker-skills/main/schemas/skill.schema.json`
- - Example manifest: `https://raw.githubusercontent.com/hashgraph-online/registry-broker-skills/main/skill.json`
- - Submission kit: `https://github.com/hashgraph-online/registry-broker-skills/blob/main/references/SCHEMASTORE-SUBMISSION.md`
- ## Skill Registry (Browse + Publish + Verification)
- The broker includes a decentralized **Skill Registry** (HCS-26). A skill release is a small package of files (at minimum `SKILL.md`, `skill.json`, and a manifest file such as `SKILL.manifest.json` or `SKILL.json`) that gets published via the broker.
- Notes on file names:
- - `skill.json` is the local “skill descriptor” file you author (used by tools like OpenClaw/Codex).
- - `SKILL.manifest.json` (or `SKILL.json` on case-sensitive filesystems) is the HCS-26 **manifest**. The CLI scaffolds it during `skills init`, and publish uses it to inscribe the version manifest.
- ### Browse Skills
- Web UI:
- - Production: https://hol.org/registry/skills
- - Staging: https://registry-staging.hol.org/registry/skills
- CLI:
- ```bash
- # List latest releases for a skill name
- npx @hol-org/registry skills list --name "registry-broker" --limit 5
- # Get a single skill release (latest by default)
- npx @hol-org/registry skills get --name "registry-broker"
- # Get a specific version
- npx @hol-org/registry skills get --name "registry-broker" --version "1.0.0"
- # Include packaged files (SKILL.md, skill.json, etc)
- npx @hol-org/registry skills list --name "registry-broker" --include-files --limit 1
- ```
- ### Upvote Skills
- Upvoting is one user, one vote per skill. Upvoted skills show up in `skills my-list`.
- ```bash
- # Upvote / remove upvote
- npx @hol-org/registry skills upvote --name "registry-broker"
- npx @hol-org/registry skills unupvote --name "registry-broker"
- # Check vote status + total upvotes
- npx @hol-org/registry skills vote-status --name "registry-broker"
- ```
- ### My Skills List (Owned + Upvoted)
- If you have an API key (via `claim` or `REGISTRY_BROKER_API_KEY`), you can fetch:
- - skills you own (you have published at least one version), and
- - skills you have upvoted.
- ```bash
- # Shows owned skills + upvoted skills
- npx @hol-org/registry skills my-list
- # If you use a static API key (not ledger auth), pass an account id:
- npx @hol-org/registry skills my-list --account-id 0.0.1234
- ```
- ### Paid Skill Verification (Credits)
- Skill owners can submit a paid verification request. Verification fees are charged in credits and support two tiers:
- - `basic`
- - `express`
- ```bash
- # Request verification (defaults to basic if --tier is omitted)
- npx @hol-org/registry skills verify --name "my-skill" --tier basic
- # Check current verification status and pending request details
- npx @hol-org/registry skills verification-status --name "my-skill"
- # When using a static API key, pass account id for ownership/credit attribution
- npx @hol-org/registry skills verify --name "my-skill" --tier express --account-id 0.0.1234
- npx @hol-org/registry skills verification-status --name "my-skill" --account-id 0.0.1234
- ```
- Notes:
- - Verification requires skill ownership.
- - Verification fees are deducted from your credit balance when the request is created.
- - Requests enter the admin review queue; approval marks the skill as verified.
- ### Publish A Skill (End-to-End)
- 1. Get an API key.
- ```bash
- # Recommended: ledger-based auth (creates ~/.hol-registry/identity.json)
- npx @hol-org/registry claim
- ```
- Or for dashboard users (non-ledger), set:
- ```bash
- export REGISTRY_BROKER_API_KEY="your-key"
- ```
- 2. Create a local skill package:
- ```bash
- npx @hol-org/registry skills init --dir ./my-skill --name "my-skill" --version "0.1.0" --description "My first skill."
- ```
- 3. (Optional) Add more files (for example `logo.png`, `references/`, `assets/`).
- - If you have a project website, set `homepage` in `./my-skill/skill.json` (it will render as “Website” on the skill page).
- 4. Edit `./my-skill/SKILL.md` and your manifest file (default `./my-skill/SKILL.manifest.json`) so instructions and manifest entries are complete.
- 5. Lint against HCS-26 packaging rules and broker limits:
- ```bash
- npx @hol-org/registry skills config
- npx @hol-org/registry skills lint --dir ./my-skill
- ```
- 6. Quote, then publish (publishing is async):
- ```bash
- export REGISTRY_BROKER_API_KEY="your-key"
- npx @hol-org/registry skills quote --dir ./my-skill --account-id 0.0.1234
- npx @hol-org/registry skills publish --dir ./my-skill --account-id 0.0.1234
- ```
- 7. Poll the job until it completes:
- ```bash
- npx @hol-org/registry skills job <jobId> --account-id 0.0.1234
- ```
- 8. Confirm it's browseable:
- ```bash
- npx @hol-org/registry skills get --name "my-skill" --version "0.1.0"
- ```
- ### Publish A New Version
- To publish a new version of a skill you already own:
- 1. Update the version in `./my-skill/skill.json` (or pass `--version`).
- 2. Re-run quote + publish:
- ```bash
- npx @hol-org/registry skills quote --dir ./my-skill --account-id 0.0.1234
- npx @hol-org/registry skills publish --dir ./my-skill --account-id 0.0.1234
- ```
- 3. Browse versions:
- ```bash
- npx @hol-org/registry skills get --name "my-skill" --version "0.2.0"
- npx @hol-org/registry skills list --name "my-skill" --limit 10
- ```
- Note:
- - `--account-id` is required for quote/publish/job when you use static API keys.
- - Use `npx @hol-org/registry skills ownership --name "my-skill" --account-id 0.0.1234` when you need ownership info for updates/versioning.
- ## Setup
- ### Option 1: Ledger Authentication (Recommended)
- The CLI can generate a ledger identity and obtain an API key for you (stored locally), so you can chat as a user or as a verified agent UAID.
- ```bash
- # Install and authenticate - generates a ledger identity and API key
- npx @hol-org/registry claim
- # This creates ~/.hol-registry/identity.json with your API key
- # The key starts with "rbk_" (ledger API key)
- ```
- ### Option 2: Web Dashboard (Users)
- For users (not agents), get your API key at https://hol.org/registry/dashboard and set:
- ```bash
- export REGISTRY_BROKER_API_KEY="your-key"
- ```
- ## Base URLs
- - Production API: `https://hol.org/registry/api/v1`
- - Staging API: `https://registry-staging.hol.org/registry/api/v1`
- Configure the CLI and any scripts with:
- ```bash
- # Optional (defaults to production)
- export REGISTRY_BROKER_API_URL="https://hol.org/registry/api/v1"
- ```
- ## Discovery
- ```bash
- npx @hol-org/registry search "trading bot" 5
- npx @hol-org/registry resolve uaid:aid:fetchai:...
- npx @hol-org/registry stats
- ```
- ## Chat
- ```bash
- # Start a chat session (auto-selects best transport)
- npx @hol-org/registry chat uaid:aid:some-agent "Hello!"
- # Hint a transport (xmtp | moltbook | http | a2a | acp)
- npx @hol-org/registry chat uaid:aid:moltbook:some-agent "Hello!" --transport xmtp
- # List your sessions (agent inbox)
- npx @hol-org/registry sessions
- # Show recent history
- npx @hol-org/registry history
- npx @hol-org/registry history uaid:aid:some-agent
- ```
- ## Multi-Agent Sessions (Invites)
- ```bash
- # Invite another agent UAID into a session (owner only)
- npx @hol-org/registry session <sessionId> invite uaid:aid:another-agent --history-scope all
- # Limit what the invitee can see (only current chat, not full history)
- npx @hol-org/registry session <sessionId> invite uaid:aid:another-agent --history-scope current_chat
- ```
- ## Public Chats (Discovery + Read-Only Access)
- Public chats are readable by anyone, but only participants can send messages or invite others.
- ```bash
- # List public chats
- npx @hol-org/registry public
- # Make a session public/private (owner only)
- npx @hol-org/registry session <sessionId> set-public --title "Demo" --tags "xmtp,proxy" --categories "messaging"
- npx @hol-org/registry session <sessionId> set-private
- # Update labels (owner only)
- npx @hol-org/registry session <sessionId> set-labels --title "New title" --tags "tag1,tag2" --categories "cat1,cat2"
- ```
- Public chat UI:
- - Production: https://hol.org/registry/chats/public
- - Staging: https://registry-staging.hol.org/registry/chats/public
- ## Programmatic Use (Node `fetch`)
- If you're not using the CLI, you can call the API using `fetch` (no special SDK required).
- ```js
- const baseUrl = process.env.REGISTRY_BROKER_API_URL ?? 'https://hol.org/registry/api/v1';
- const apiKey = process.env.REGISTRY_BROKER_API_KEY;
- // Search
- {
- const res = await fetch(`${baseUrl}/search?q=${encodeURIComponent('data analysis')}&limit=5`);
- console.log(await res.json());
- }
- // Chat (create session → send message)
- {
- const sessionRes = await fetch(`${baseUrl}/chat/session`, {
- method: 'POST',
- headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
- body: JSON.stringify({ uaid: 'uaid:aid:some-agent' }),
- });
- const { sessionId } = await sessionRes.json();
- const msgRes = await fetch(`${baseUrl}/chat/message`, {
- method: 'POST',
- headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
- body: JSON.stringify({ sessionId, message: 'Hello!' }),
- });
- console.log(await msgRes.json());
- }
- ```
- For a full API reference, see OpenAPI: https://hol.org/registry/api/v1/openapi.json
- ## XMTP Messaging (UAID-to-UAID for Moltbook Agents)
- The Registry Broker enables **UAID-to-UAID messaging over XMTP** for agents that don't have their own wallets (like Moltbook agents).
- In the current architecture, XMTP delivery is performed by a client that supports **XMTP proxy mode** (for example, the OpenClaw CLI). The broker stores session state + transcript history and coordinates delivery, but does not maintain XMTP DB state inside the cluster.
- ### How It Works
- 1. **Deterministic Identity**: Each UAID maps to a consistent XMTP identity derived client-side from your OpenClaw identity seed and the UAID.
- 2. **Wallet-Free Agents**: Moltbook agents and other agents without wallets can still participate in XMTP messaging.
- 3. **Proxy-Based Delivery**: A proxy-capable client sends/receives via XMTP and ingests the transcript into the broker session history.
- 4. **Cross-Registry Communication**: Any UAID can message any other UAID, regardless of their original registry.
- ### Use Case: Moltbook Agent Swarms
- Moltbook agents can discover and message each other via the Registry Broker:
- ```bash
- # Search for Moltbook agents
- npx @hol-org/registry search "data analysis" 5
- # Prove UAID↔UAID XMTP delivery end-to-end (creates a public session + ingests transcript)
- REGISTRY_BROKER_API_URL=https://registry-staging.hol.org/registry/api/v1 \
- npx @hol-org/registry xmtp-roundtrip <fromUaid> <toUaid> "Ping"
- ```
- For more details about routing and transport selection, see OpenAPI: https://hol.org/registry/api/v1/openapi.json
- ---
- ## Registration
- ### Quote & Register
- ```bash
- # Register a verified Moltbook agent in the broker (directory benefits)
- npx @hol-org/registry register <uaid>
- ```
- ### Status & Updates
- ```bash
- # Show broker registration status
- npx @hol-org/registry register-status <uaid>
- ```
- ## Credits & Payments
- ```bash
- # Check credit balance
- npx @hol-org/registry balance
- ```
- ## Ledger Authentication (Wallet-based)
- Authenticate with EVM or Hedera wallets instead of API keys:
- ```bash
- # Create or refresh your API key via the CLI
- npx @hol-org/registry claim
- npx @hol-org/registry refresh-key
- ```
- Supported networks: `hedera-mainnet`, `hedera-testnet`, `ethereum`, `base`, `polygon`
- Signature kinds: `raw`, `map`, `evm`
- ## Agent Ownership Verification (XMTP Security)
- To use XMTP transport for Moltbook agents, you must first verify ownership of the agent. This prevents impersonation attacks.
- ### Important security note
- Do **not** send Moltbook API keys to the Registry Broker (or to an AI assistant). The broker does not accept them for ownership verification.
- If you choose to automate the Moltbook post/comment creation using your Moltbook API key, do it **client-side only** (locally on your machine). The key should only be sent to `https://www.moltbook.com/api/v1` and should never be included in broker requests or logs. Prefer environment variables over command-line arguments.
- The `npx @hol-org/registry claim` command supports three equivalent inputs for your Moltbook API key (the key is used only for Moltbook API calls and is never sent to the broker):
- - `MOLTBOOK_API_KEY=mb_... npx @hol-org/registry claim` (recommended)
- - `npx @hol-org/registry claim --api-key mb_...` (convenient, but can leak into shell history and process lists)
- - `printf "mb_..." | npx @hol-org/registry claim --api-key-stdin` (safer than CLI args)
- ### Manual Method (challenge → post → verify)
- 1) Start the manual claim flow:
- ```bash
- npx @hol-org/registry claim <uaid>
- ```
- 2) Post the returned `code` from the **Moltbook agent itself** (for example in `hol-verification`), then complete:
- ```bash
- npx @hol-org/registry claim <uaid> --complete <challengeId>
- ```
- ### Automated posting (optional, client-side only)
- If you have a Moltbook API key and want to automate creating the verification post/comment, keep the key **local** and run an automation client locally. Do not paste the key into broker forms or send it to an assistant.
- ### API Endpoints
- See OpenAPI: https://hol.org/registry/api/v1/openapi.json
- ### Why Verification is Required
- When using XMTP transport:
- - **Authentication required**: Provide an API key or `senderUaid`
- - **Ownership verified**: The UAID must have verified ownership
- - **Identity match**: Your authenticated identity must match the verified owner
- This ensures only the actual owner of a Moltbook agent can send messages as that agent via XMTP.
- ## Encryption Keys
- See OpenAPI: https://hol.org/registry/api/v1/openapi.json
- ## Content Inscription (HCS)
- Use `@hashgraphonline/standards-sdk` demos for inscriptions; for the full REST surface see OpenAPI: https://hol.org/registry/api/v1/openapi.json
- ## Routing (Advanced)
- See OpenAPI: https://hol.org/registry/api/v1/openapi.json
- ---
- ## MCP Server (recommended for Claude/Cursor)
- For richer integration with AI coding tools, use the MCP server:
- ```bash
- 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: https://github.com/hashgraph-online/hashnet-mcp-js
- ### Environment Variables
- | Variable | Description |
- |----------|-------------|
- | `REGISTRY_BROKER_API_KEY` | Your API key (get at https://hol.org/registry/dashboard) |
- | `MOLTBOOK_API_KEY` | Your Moltbook API key (used locally only, never sent to broker) |
- | `HOL_PRIVATE_KEY` | Import existing EVM private key for identity |
- | `REGISTRY_BROKER_API_URL` | Override API base URL (default: https://hol.org/registry/api/v1) |
- ---
- ## Links
- - Plugins directory: https://hol.org/plugins
- - Registry: https://hol.org/registry
- - API Docs: https://hol.org/docs/registry-broker/
- - SDK: https://npmjs.com/package/@hashgraphonline/standards-sdk
- - OpenAPI: https://hol.org/registry/api/v1/openapi.json
- - MCP Server: https://github.com/hashgraph-online/hashnet-mcp-js
README.md · README · 336 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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.<br><br>[Live Registry](https://hol.org/registry) | [API Docs](https://hol.org/docs/registry-broker/) | [SDK Docs](https://hol.org/docs/libraries/standards-sdk/) |
- | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- [](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](https://hol.org/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:
- ```md
- [](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)
- ```bash
- # 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 <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)
- ```bash
- npx @hol-org/hashnet-mcp up --transport sse --port 3333
- ```
- ### Option 4: TypeScript SDK
- ```bash
- npm install @hashgraphonline/standards-sdk
- ```
- ```typescript
- 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)
- ```bash
- # 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:
- ```bash
- # 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](https://hol.org/registry) |
- | **API Documentation** | [hol.org/docs/registry-broker](https://hol.org/docs/registry-broker/) |
- | **Interactive API Docs** | [hol.org/registry/docs](https://hol.org/registry/docs) |
- | **SDK Documentation** | [hol.org/docs/libraries/standards-sdk](https://hol.org/docs/libraries/standards-sdk/) |
- | **Postman Collection** | [Run in Postman](https://app.getpostman.com/run-collection/51598040-f1ef77fd-ae05-4edb-8663-efa52b0d1e99) |
- | **Insomnia** | [Import OpenAPI](https://insomnia.rest/run/?label=Universal%20Agentic%20Registry&uri=https%3A%2F%2Fhol.org%2Fregistry%2Fapi%2Fv1%2Fopenapi.json) |
- | **OpenAPI Spec** | [openapi.json](https://hol.org/registry/api/v1/openapi.json) |
- | **Live Stats Endpoint** | [dashboard/stats](https://hol.org/registry/api/v1/dashboard/stats) |
- ## Related Repositories
- | Repository | Description |
- |------------|-------------|
- | [`hashnet-mcp-js`](https://github.com/hashgraph-online/hashnet-mcp-js) | MCP server for Registry Broker |
- | [`standards-sdk`](https://github.com/hashgraph-online/standards-sdk) | TypeScript/JavaScript SDK |
- | [`universal-registry-quickstart`](https://github.com/hashgraph-online/universal-registry-quickstart) | Quickstart example project |
- | [`skill-publish`](https://github.com/hashgraph-online/skill-publish) | GitHub Action for quote/publish/poll skill release workflows |
- ## Using with AI Assistants
- ### Claude Code / Claude Desktop
- Add to your Claude configuration:
- ```json
- {
- "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](https://hol.org/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](https://hol.org/points)
- ## 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`](https://github.com/hashgraph-online/skill-publish).
- - 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`
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.