MCP Server

Maintained

io.github.hashgraph-online/hashnet MCP Server

io.github.hashgraph-online/hashnet

Universal AI agent discovery and registration across 59,000+ agents in MCP, NANDA, A2A, and OpenRouter ecosystems.

What is the io.github.hashgraph-online/hashnet MCP server?

Hashnet MCP JS is a universal MCP server for discovering, searching, and interacting with AI agents across multiple registries including MCP, NANDA, A2A, and OpenRouter. It provides tools for agent discovery, chat sessions, agent registration, and workflow automation through the HOL Registry Broker ecosystem.

Hashnet enables AI agents to discover and interact with 59,000+ other agents across multiple platforms. It offers search and vector search capabilities, real-time chat with discovered agents, agent registration workflows, and credit management—all accessible through a single MCP interface with support for stdio and HTTP transports.

How to install io.github.hashgraph-online/hashnet

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

REGISTRY_BROKER_API_KEY
secret
Your Registry Broker API key from https://hol.org

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hashnet": {
      "command": "npx",
      "args": [
        "-y",
        "@hol-org/hashnet-mcp"
      ],
      "env": {
        "REGISTRY_BROKER_API_KEY": "<YOUR_REGISTRY_BROKER_API_KEY>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

hol.stats — Retrieve statistics about available agents and registries
hol.capabilities — Query capabilities across the agent ecosystem
hol.search — Search agents by name, description, or metadata
hol.vectorSearch — Semantic vector search across agent descriptions
hol.resolveUaid — Resolve universal agent identifiers
hol.chat.readiness — Check agent readiness for chat sessions
hol.chat.createSession — Create a new chat session with an agent
hol.chat.sendMessage — Send messages within an active chat session
hol.chat.retry — Retry failed messages in a session
hol.chat.history — Retrieve chat session history
hol.chat.resume — Resume a previous chat session
hol.chat.end — Terminate a chat session
hol.getRegistrationQuote — Get pricing information for agent registration
hol.registerAgent — Register a new agent in the ecosystem
hol.waitForRegistrationCompletion — Poll for agent registration completion status
workflow.discovery — Automated agent discovery workflows
workflow.delegate — Delegate tasks to discovered agents
workflow.registration — Automated agent registration workflows

Use cases

Search and discover AI agents across multiple registries to find specialized tools for specific tasks
Establish chat sessions with discovered agents to collaborate on complex workflows
Register new AI agents into the ecosystem and manage their availability
Automate agent discovery and delegation workflows for multi-agent orchestration
Query agent capabilities and statistics to understand the broader AI agent landscape

io.github.hashgraph-online/hashnet MCP server FAQ

What is Hashnet MCP?

Hashnet is an MCP server that provides universal discovery, search, and interaction capabilities for 59,000+ AI agents across MCP, NANDA, A2A, and OpenRouter registries. It enables agent-to-agent communication, registration, and workflow automation.

Is Hashnet free to use?

Basic discovery and search tools are available without authentication. Paid tools require a `REGISTRY_BROKER_API_KEY` for access to advanced features like agent registration and premium workflows.

How do I install Hashnet in Cursor or Claude?

Install via npm: `npm install @hol-org/hashnet-mcp`. Then configure your MCP settings to run `npx @hol-org/hashnet-mcp --stdio` or `--http` depending on your client's transport preference.

What authentication is required?

Optional: set `REGISTRY_BROKER_API_KEY` for paid features. Optional Hedera or EVM ledger credentials can be configured for blockchain-backed workflows. The server enforces bearer-token auth when binding to non-local hosts.

What transports does Hashnet support?

Hashnet supports stdio (best for local runtimes), Streamable HTTP (recommended), and legacy HTTP+SSE. It includes health check and metrics endpoints for monitoring.

Can I use Hashnet to automate agent workflows?

Yes. Hashnet provides workflow tools for automated discovery, task delegation, and agent registration, enabling multi-agent orchestration and coordination across the ecosystem.

README (reference)

Source of truth, from the repository.

Hashnet MCP JS

Universal MCP server for discovery, chat, registration, credits, and workflow automation across the HOL Registry Broker ecosystem.

Ecosystem

Surface	Link
npm package	`@hol-org/hashnet-mcp`
GitHub repo	hashgraph-online/hashnet-mcp-js
GitHub releases	Releases
Documentation	hol.org/mcp
CodeSandbox	Open examples in browser

Quickstart

pnpm install
cp .env.example .env
pnpm dev:http

Common launch modes:

pnpm dev:stdio
pnpm dev:http
pnpm dev:http:compat
npx @hol-org/hashnet-mcp --help
npx @hol-org/hashnet-mcp --stdio
npx @hol-org/hashnet-mcp --http --host 127.0.0.1 --port 3333

When installed globally or linked locally, the binary is hashnet-mcp.

Supported Transports

Transport	Endpoint(s)	Notes
stdio	process stdin/stdout	best for local agent runtimes
Streamable HTTP	`/mcp`, `/mcp/stream`	recommended HTTP transport
legacy HTTP + SSE	`/mcp/sse`, `/mcp/messages`	enabled with `FEATURE_LEGACY_SSE=1`

Runtime utility endpoints:

/healthz
/readyz
/metrics

Tool Surface

Discovery: hol.stats, hol.capabilities, hol.search, hol.vectorSearch, hol.resolveUaid
Chat: hol.chat.readiness, hol.chat.createSession, hol.chat.sendMessage, hol.chat.retry, hol.chat.history, hol.chat.resume, hol.chat.end
Registration: hol.getRegistrationQuote, hol.registerAgent, hol.waitForRegistrationCompletion
Workflows: workflow.discovery, workflow.delegate, workflow.registration

Tool success responses use structured envelopes in structuredContent:

ok
data
meta

Tool failures return isError: true with structured machine-readable error fields (code, category, retryable).

Configuration

Variable	Required	Notes
`REGISTRY_BROKER_API_URL`	no	defaults to `https://hol.org/registry/api/v1`
`REGISTRY_BROKER_API_KEY`	no	enables paid tools with a static broker API key
`BROKER_REQUEST_TIMEOUT_MS`	no	default upstream request timeout is `60000`
`MCP_TRANSPORT`	no	`http` (default) or `stdio`
`MCP_HOST`	no	defaults to `127.0.0.1`
`MCP_PORT`	no	defaults to `3333`
`MCP_ALLOWED_ORIGINS`	no	comma-separated allow list
`MCP_SERVER_BEARER_TOKEN`	no	required when binding to a non-local host (for example `0.0.0.0`)
`MCP_SESSION_IDLE_TTL_MS`	no	defaults to `900000`
`MCP_SESSION_MAX_COUNT`	no	defaults to `250`
`MCP_SESSION_REAP_INTERVAL_MS`	no	defaults to `60000`
`LEDGER_ACCOUNT_ID`	no	generic ledger identity fallback
`HEDERA_ACCOUNT_ID`	no	Hedera account id
`HEDERA_NETWORK`	no	e.g. `hedera:testnet`
`HEDERA_PRIVATE_KEY`	no	Hedera private key
`EVM_LEDGER_NETWORK`	no	e.g. `eip155:1`
`ETH_PK`	no	EVM private key

Security Defaults

Binds to 127.0.0.1 by default.
Validates Origin for HTTP requests when present.
Enforces bearer-token auth when binding to non-local hosts.
Reaps idle HTTP sessions and enforces max active sessions.
Redacts sensitive values in logs.

Development

Command	Purpose
`pnpm build`	compile distributable artifacts
`pnpm start`	run compiled server
`pnpm lint`	run ESLint
`pnpm typecheck`	run TypeScript checks
`pnpm test:run`	run Vitest once
`pnpm test:coverage`	run Vitest with coverage
`pnpm check:no-stubs`	enforce no-stubs contract
`pnpm smoke:http`	streamable HTTP smoke test
`pnpm smoke:stdio`	stdio smoke test

Release Notes Automation

GitHub releases are generated automatically from merged pull requests:

release tags are created during publish (vX.Y.Z)
GitHub release notes are generated with GitHub's release-note engine
changelog categories are controlled via .github/release.yml
canonical docs links are appended to each release

Related MCP servers

HOL Guard

Active

Local-first antivirus for AI agents—detect and block secrets, prompt injection, unsafe commands, and supply-chain risks before execution.

453

Python

Apache-2.0

View repository →

Terraform

Active

Integrate Terraform Registry and HCP Terraform with AI agents for infrastructure automation.

1.5k

MPL-2.0

View repository →

Next.js Architecture MCP

Indexes your Next.js project so an agent finds the file that owns a task in one call.

Giggal.ai

Active

Runs a deep mailbox existence check to verify catch-all, accept-all, and SEG protected emails.

TypeScript

MIT

View repository →

io.github.hassanahashish-design/agent-signals-mcp

Maintained

Hiring, SEC, research papers, GitHub & Hacker News as JSON for AI agents. Pay-per-result on Apify.

JavaScript

View repository →

Forex-GPT MCP Server

AI-powered forex and crypto trading analysis with real-time data across 127+ instruments.