Skip to content

hashgraph-online/langchain-registry-broker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@hol-org/langchain-registry-broker

LangChain tools for Registry Broker - Universal AI Agent Discovery.

npm version npm downloads License TypeScript

Open in StackBlitz Open in CodeSandbox

What is Registry Broker?

Registry Broker is a universal index and routing layer for AI agents. It aggregates agent metadata from multiple registries:

  • NANDA - Agentic protocol for AI coordination
  • MCP - Model Context Protocol servers
  • OpenRouter - LLM routing and models
  • A2A - Agent-to-Agent protocol
  • Virtuals - Virtual agents platform
  • Olas - Autonomous agent network

Installation

npm install @hol-org/langchain-registry-broker @langchain/core zod
pnpm add @hol-org/langchain-registry-broker @langchain/core zod
yarn add @hol-org/langchain-registry-broker @langchain/core zod

Quick Start

import { createRegistryBrokerTools } from '@hol-org/langchain-registry-broker';
import { ChatOpenAI } from '@langchain/openai';
import { AgentExecutor, createOpenAIFunctionsAgent } from 'langchain/agents';

// Create Registry Broker tools
const tools = createRegistryBrokerTools();

// Use with LangChain agent
const llm = new ChatOpenAI({ model: 'gpt-4o-mini' });
const agent = await createOpenAIFunctionsAgent({ llm, tools, prompt });
const executor = new AgentExecutor({ agent, tools });

// Ask the agent to find specialized AI agents
const response = await executor.invoke({
  input: 'Find me an AI agent that can help with code review',
});

Available Tools

registry_broker_search

Search for AI agents across all indexed protocols.

import { RegistryBrokerSearchTool } from '@hol-org/langchain-registry-broker';

const searchTool = new RegistryBrokerSearchTool();

// Simple text search
await searchTool.invoke('code review assistant');

// Filtered search
await searchTool.invoke(JSON.stringify({
  query: 'research assistant',
  protocol: 'mcp',        // Filter by protocol
  capability: 'research', // Filter by capability
  limit: 10
}));

registry_broker_agent_details

Get detailed information about a specific agent by UAID.

import { RegistryBrokerAgentDetailsTool } from '@hol-org/langchain-registry-broker';

const detailsTool = new RegistryBrokerAgentDetailsTool();
await detailsTool.invoke('uaid:aid:example;uid=agent-1;registry=demo;proto=mcp');

API

createRegistryBrokerTools(baseUrl?: string): Tool[]

Creates both search and details tools with an optional custom base URL.

RegistryBrokerSearchTool

  • name: registry_broker_search
  • description: Search for AI agents across multiple protocols
  • input: Query string or JSON with query, protocol, capability, limit

RegistryBrokerAgentDetailsTool

  • name: registry_broker_agent_details
  • description: Get detailed information about a specific agent
  • input: UAID (Universal Agent ID) string

Links

License

Apache 2.0

About

LangChain tools for Universal AI Agent Discovery - 59,000+ agents across NANDA, MCP, A2A, Virtuals | https://hol.org

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors