Hashnet
- 13 repo stars
- Updated May 8, 2026
- hashgraph-online/hashnet-mcp-js
Hashnet is an MCP server that searches 59,000+ AI agents across MCP, NANDA, A2A, and OpenRouter for discovery and comparison.
About
io.github.hashgraph-online/hashnet is Hashgraph Online’s Hashnet MCP server for universal AI agent discovery. developers drowning in fragmented registries can query more than fifty-nine thousand agents spanning MCP, NANDA, A2A, and OpenRouter through a single stdio connection in Claude Code, Cursor, or similar clients. Install @hol-org/hashnet-mcp from npm, optionally configure REGISTRY_BROKER_API_KEY from hol.org, and let your agent search, filter, and reason about third-party agents before you wire custom orchestration. It sits early in the journey—Ideal phase, Discover—when you are comparing automation stacks, multi-agent patterns, or hosted routers versus self-hosted MCP. Intermediate complexity reflects broker keys and interpreting heterogeneous registry metadata. It complements Skillselion’s skill directory by focusing on live agent listings across protocols, not repository-local SKILL.md packs.
- Search 59,000+ agents across MCP, NANDA, A2A, and OpenRouter from one MCP server
- npm package @hol-org/hashnet-mcp (v1.0.24) with stdio transport
- Registry Broker API key from hol.org for authenticated discovery
- Cross-protocol lookup so you are not siloed to a single agent marketplace
Hashnet by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
claude mcp add --env REGISTRY_BROKER_API_KEY=YOUR_REGISTRY_BROKER_API_KEY hashnet -- npx -y @hol-org/hashnet-mcpAdd your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| repo stars | ★ 13 |
|---|---|
| Package | @hol-org/hashnet-mcp |
| Transport | STDIO |
| Auth | Required |
| Last updated | May 8, 2026 |
| Repository | hashgraph-online/hashnet-mcp-js ↗ |
What it does
Search and compare agents across MCP, NANDA, A2A, and OpenRouter registries before you commit to an architecture or vendor.
Who is it for?
Best when you're planning multi-agent or MCP-heavy products and need a single discovery surface before Build integrations.
Skip if: Skip if you already standardized on one in-house agent with no external registry needs.
What you get
With Hashnet MCP configured, your agent can query a unified discovery index across major agent ecosystems and narrow options before you integrate.
- Unified agent search results across MCP, NANDA, A2A, and OpenRouter
- Shortlists and metadata your agent can use in architecture notes or integration plans
- Repeatable discovery queries without manual registry websites
By the numbers
- Catalog scale stated as 59,000+ agents
- Protocols: MCP, NANDA, A2A, OpenRouter
- npm @hol-org/hashnet-mcp version 1.0.24, stdio transport
README.md
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:stdiopnpm dev:httppnpm dev:http:compatnpx @hol-org/hashnet-mcp --helpnpx @hol-org/hashnet-mcp --stdionpx @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:
okdatameta
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.1by default. - Validates
Originfor 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
Recommended MCP Servers
0Latency MemoryPersistent memory layer for AI agents.
0nMCP — Universal AI API OrchestratorUniversal AI API Orchestrator — 1,554 tools, 96 services.
0xHumans Protocol MCPMCP for AI agents: financing, skills, lending on Base1k Patient Mcp1k patient MCP server
1trippulse1trip PULSE: 21-tool AI travel planner.
3D AI Agent Avatar3D AI Agent Avatar — render any GLB, give it a Solana wallet, a voice, and pump.fun powers.89How it compares
Cross-registry agent search MCP, not a skill that implements business logic inside your repo.
FAQ
Who is Hashnet MCP for?
It is for and small-team developers evaluating third-party AI agents across MCP, NANDA, A2A, and OpenRouter before they commit to an integration path.
When should I use Hashnet MCP?
Use it during idea and discovery when you need to find, compare, or shortlist external agents instead of building every capability from scratch.
How do I add Hashnet MCP to my agent?
Add the stdio server for @hol-org/hashnet-mcp (npm), set REGISTRY_BROKER_API_KEY from hol.org if required, and restart your MCP client.