hashnet-mcp-js is a general-purpose MCP server launched by Hashgraph Online, positioned as an entry point to "discover and connect with agents anywhere in the world," while providing discovery, chat, registration, credits, and workflow automation capabilities around the HOL Registry Broker ecosystem.
Purpose This tool is aimed at developers who want to access agent discovery and registration processes through the standardized MCP protocol. It can be used both for invocation from MCP clients (such as MCP-enabled editors or agent frameworks) and as a standalone process, helping to retrieve, connect to, and register AI agents on the Hashgraph network.
Main capabilities According to the official description, the server provides the following tool categories:
- 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. Successful tool responses are returned using a structured envelope in structuredContent; on failure, isError: true is returned, along with machine-readable error fields (code, category, retryable).
Usage Common startup modes given officially include:
- 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 After global installation or local linking, the binary command name is hashnet-mcp. The project supports both stdio and HTTP transport modes, and includes runtime tool endpoints. The official documentation entry point is https://hol.org/mcp。
Secure defaults
- Bind to 127.0.0.1 by default.
- Validate Origin for HTTP requests (when present).
- Enforce bearer-token authentication when binding to a non-local host.
- Clean up idle HTTP sessions and limit the maximum number of active sessions.
- Sensitive values in logs are redacted.
Release notes automation GitHub Releases are automatically generated from merged pull requests: a version tag (vX.Y.Z) is created at release time; GitHub's release-note engine is used to generate release notes; changelog categorization is controlled via .github/release.yml; each release is attached with a link to the official documentation.
Use cases Suitable for development and automation scenarios that need to access Hashgraph agent registration and discovery via MCP, conduct agent chat interactions, query registration quotes and complete agent registration, and orchestrate discovery/delegation/registration workflows.
Limitations Details such as the specific mechanism of the credits system, registration fees, the number and types of available agents, the account or key configuration required to run, deployment environment requirements, and the list of supported MCP clients are not provided in the official materials and are not yet available.
