English Français العربية

io.github.hashgraph-online/hashnet

Official registry Search and web

Universal AI Agent Discovery - search 59,000+ agents across MCP, NANDA, A2A, OpenRouter

Source code Documentation

What can you do with io.github.hashgraph-online/hashnet?

  • 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
  • ok
  • data
  • meta

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @hol-org/hashnet-mcp
Claude Code 
claude mcp add hashnet -e 'REGISTRY_BROKER_API_KEY=<your registry_broker_api_key>' -- npx -y @hol-org/hashnet-mcp@1.0.24
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hashnet": {
            "command": "npx",
            "args": [
                "-y",
                "@hol-org/hashnet-mcp@1.0.24"
            ],
            "env": {
                "REGISTRY_BROKER_API_KEY": "<your registry_broker_api_key>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Hashnet MCP JS
  2. Ecosystem
  3. Quickstart
  4. Supported Transports
  5. Tool Surface
  6. Configuration
  7. Security Defaults
  8. Development
  9. Release Notes Automation

Hashnet MCP JS

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

Ecosystem

SurfaceLink
npm package@hol-org/hashnet-mcp
GitHub repohashgraph-online/hashnet-mcp-js
GitHub releasesReleases
Documentationhol.org/mcp
CodeSandboxOpen 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

TransportEndpoint(s)Notes
stdioprocess stdin/stdoutbest for local agent runtimes
Streamable HTTP/mcp, /mcp/streamrecommended HTTP transport
legacy HTTP + SSE/mcp/sse, /mcp/messagesenabled 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

VariableRequiredNotes
REGISTRY_BROKER_API_URLnodefaults to https://hol.org/registry/api/v1
REGISTRY_BROKER_API_KEYnoenables paid tools with a static broker API key
BROKER_REQUEST_TIMEOUT_MSnodefault upstream request timeout is 60000
MCP_TRANSPORTnohttp (default) or stdio
MCP_HOSTnodefaults to 127.0.0.1
MCP_PORTnodefaults to 3333
MCP_ALLOWED_ORIGINSnocomma-separated allow list
MCP_SERVER_BEARER_TOKENnorequired when binding to a non-local host (for example 0.0.0.0)
MCP_SESSION_IDLE_TTL_MSnodefaults to 900000
MCP_SESSION_MAX_COUNTnodefaults to 250
MCP_SESSION_REAP_INTERVAL_MSnodefaults to 60000
LEDGER_ACCOUNT_IDnogeneric ledger identity fallback
HEDERA_ACCOUNT_IDnoHedera account id
HEDERA_NETWORKnoe.g. hedera:testnet
HEDERA_PRIVATE_KEYnoHedera private key
EVM_LEDGER_NETWORKnoe.g. eip155:1
ETH_PKnoEVM 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

CommandPurpose
pnpm buildcompile distributable artifacts
pnpm startrun compiled server
pnpm lintrun ESLint
pnpm typecheckrun TypeScript checks
pnpm test:runrun Vitest once
pnpm test:coveragerun Vitest with coverage
pnpm check:no-stubsenforce no-stubs contract
pnpm smoke:httpstreamable HTTP smoke test
pnpm smoke:stdiostdio 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

Frequently asked questions

What is io.github.hashgraph-online/hashnet?

Universal AI Agent Discovery - search 59,000+ agents across MCP, NANDA, A2A, OpenRouter

How do I install io.github.hashgraph-online/hashnet?

It runs on your machine. In Claude Code: claude mcp add hashnet -e 'REGISTRY_BROKER_API_KEY=<your registry_broker_api_key>' -- npx -y @hol-org/hashnet-mcp@1.0.24. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.hashgraph-online/hashnet need an API key?

Yes. It expects REGISTRY_BROKER_API_KEY, which you set in its configuration.

Is io.github.hashgraph-online/hashnet open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.hashgraph-online/hashnet?

It is published by hashgraph-online. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.