npm package: @hol-org/ai-sdk-registry-broker
Description: Vercel AI SDK tools for Registry Broker - Universal AI Agent Discovery across 59,000+ agents from NANDA, MCP, OpenRouter, A2A, Virtuals, and more
Author: Hashgraph Online
Latest version: 0.1.1

# Vercel AI SDK Registry Broker

| ![](https://github.com/hashgraph-online/standards-sdk/raw/main/Hashgraph-Online.png) | **Vercel AI SDK tools for the Universal Agentic Registry.** Discover, search, and connect with 59,000+ AI agents across NANDA, MCP, OpenRouter, A2A, Virtuals, and more.<br><br>[📚 SDK Documentation](https://hol.org/docs/libraries/standards-sdk/)<br>[📖 API Documentation](https://hol.org/docs/registry-broker/) |
| :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

[![npm version](https://img.shields.io/npm/v/@hol-org/ai-sdk-registry-broker?style=for-the-badge&logo=npm&logoColor=white&label=ai-sdk-registry-broker)](https://www.npmjs.com/package/@hol-org/ai-sdk-registry-broker)
[![npm version](https://img.shields.io/npm/v/@hashgraphonline/standards-sdk?style=for-the-badge&logo=npm&logoColor=white&label=standards-sdk)](https://www.npmjs.com/package/@hashgraphonline/standards-sdk)
[![Run in Postman](https://img.shields.io/badge/Run_in-Postman-FF6C37?style=for-the-badge&logo=postman&logoColor=white)](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)
[![OpenAPI Spec](https://img.shields.io/badge/OpenAPI-3.1.0-6BA539?style=for-the-badge&logo=openapiinitiative&logoColor=white)](https://hol.org/registry/api/v1/openapi.json)

[![Open in CodeSandbox](https://img.shields.io/badge/Open_in-CodeSandbox-blue?style=for-the-badge&logo=codesandbox&logoColor=white)](https://codesandbox.io/s/github/hashgraph-online/ai-sdk-registry-broker)
[![Open in StackBlitz](https://img.shields.io/badge/Open_in-StackBlitz-1269D3?style=for-the-badge&logo=stackblitz&logoColor=white)](https://stackblitz.com/github/hashgraph-online/ai-sdk-registry-broker)
[![Open in Replit](https://img.shields.io/badge/Open_in-Replit-667881?style=for-the-badge&logo=replit&logoColor=white)](https://replit.com/github/hashgraph-online/ai-sdk-registry-broker)
[![Open in Gitpod](https://img.shields.io/badge/Open_in-Gitpod-FFAE33?style=for-the-badge&logo=gitpod&logoColor=white)](https://gitpod.io/#https://github.com/hashgraph-online/ai-sdk-registry-broker)

## What is the Universal Registry?

The [Universal Agentic Registry](https://hol.org/docs/registry-broker/) 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

```bash
npm install @hol-org/ai-sdk-registry-broker ai zod
# or
pnpm add @hol-org/ai-sdk-registry-broker ai zod
```

## Quick Start

```typescript
import { generateText, stepCountIs } from 'ai';
import { openai } from '@ai-sdk/openai';
import { createRegistryBrokerTools } from '@hol-org/ai-sdk-registry-broker';

const tools = createRegistryBrokerTools();

const result = await generateText({
  model: openai('gpt-4o'),
  tools,
  stopWhen: stepCountIs(3),
  prompt: 'Find me an AI agent that can help with code review',
});

console.log(result.text);
```

## Available Tools

### `searchAgents`
Search for AI agents across 59,000+ indexed agents from multiple protocols.

```typescript
const result = await generateText({
  model: openai('gpt-4o'),
  tools: { searchAgents: registryBrokerSearchTool() },
  prompt: 'Find AI agents for data analysis',
});
```

### `resolveAgent`
Get detailed information about a specific agent by its UAID.

### `listProtocols`
List all supported protocols (NANDA, MCP, A2A, etc.).

### `listRegistries`
List all indexed agent registries.

### `getStats`
Get Registry Broker statistics.

## Configuration

```typescript
const tools = createRegistryBrokerTools({
  baseUrl: 'https://hol.org/registry/api/v1', // Optional
  apiKey: 'your-api-key', // Optional
});
```

## 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/) |
| **SDK Reference** | [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) |
| **OpenAPI Spec** | [openapi.json](https://hol.org/registry/api/v1/openapi.json) |
| **npm Package** | [@hol-org/ai-sdk-registry-broker](https://www.npmjs.com/package/@hol-org/ai-sdk-registry-broker) |

## Related Repositories

- [`standards-sdk`](https://github.com/hashgraph-online/standards-sdk) - The core SDK powering the registry client
- [`langchain-registry-broker`](https://github.com/hashgraph-online/langchain-registry-broker) - LangChain integration
- [`llamaindex-registry-broker`](https://github.com/hashgraph-online/llamaindex-registry-broker) - LlamaIndex integration

## 🏆 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