Hol Cursorrules

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 | | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

[](https://www.npmjs.com/package/@hashgraphonline/standards-sdk) [](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://hol.org/registry/api/v1/openapi.json)

[](https://codesandbox.io/s/github/hashgraph-online/hol-cursorrules) [](https://stackblitz.com/github/hashgraph-online/hol-cursorrules) [](https://gitpod.io/#https://github.com/hashgraph-online/hol-cursorrules)

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](LICENSE) for details.

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/hol-cursorrules
• License: MIT

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