HOL Cursor Rules

	Cursor AI rules for the Universal Agentic Registry. Build AI agents that discover and connect with 59,000+ agents across NANDA, MCP, A2A, Virtuals, and more. 📚 SDK Documentation 📖 API Documentation

What is the Universal Registry?

The Universal Agentic Registry is the connectivity layer for the autonomous web. One standards-compliant API to access agents from:

Protocol	Description
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
OpenConvAI	Conversational AI standard
XMTP	Decentralized messaging
ANS	Agent Name Service

Installation

Copy .cursorrules to your project root:

curl -O https://raw.githubusercontent.com/hashgraph-online/hol-cursorrules/main/.cursorrules

What's Included

The .cursorrules file configures Cursor AI with:

Technology Stack

• TypeScript strict mode with proper typing
• Node.js 20+ with pnpm
• Jest testing with @swc/jest
• Next.js 14+ for frontend (when applicable)

HOL SDK Integration

Real, working code examples for:

• RegistryBrokerClient initialization with API keys
• Agent search with filters and pagination
• UAID resolution for agent discovery
• Agent registration with auto top-up
• Chat conversations with agents
• Vector search for semantic agent discovery
• Stats and registry queries

Code Quality

• Strict TypeScript rules (no any)
• File naming conventions (kebab-case)
• Max 500 lines per file
• TDD workflow (red → green → refactor)

Example: Search for Agents

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

const client = new RegistryBrokerClient();

const results = await client.search({
  q: 'weather',
  registry: 'hcs-10',
  limit: 10,
});

results.hits.forEach(agent => {
  console.log(`${agent.name}: ${agent.description}`);
});

Example: Chat with an Agent

const conversation = await client.chat.start({
  uaid: 'hcs10://0.0.123456/weather-agent',
  auth: {
    accountId: process.env.HEDERA_OPERATOR_ID!,
    privateKey: process.env.HEDERA_OPERATOR_KEY!,
  },
});

const response = await conversation.sendMessage({
  content: 'What is the weather in New York?',
});

API & Documentation

Resource	Link
Live Registry	hol.org/registry
API Documentation	hol.org/docs/registry-broker
SDK Reference	hol.org/docs/libraries/standards-sdk
Postman Collection	Run in Postman
OpenAPI Spec	openapi.json
npm Package	@hashgraphonline/standards-sdk

Related Repositories

• standards-sdk - The core SDK powering the registry client
• hol-claude-skills - Claude Code slash commands for HOL
• hol-claude-md - CLAUDE.md templates for HOL projects

🏆 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

MIT License - see LICENSE for details.