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?

Clone io.github.hashgraph-online/hashnet from https://github.com/hashgraph-online/hashnet-mcp-js and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

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

Yes, io.github.hashgraph-online/hashnet is open source under the NOASSERTION license. Source code is available at https://github.com/hashgraph-online/hashnet-mcp-js.

What category does io.github.hashgraph-online/hashnet belong to?

io.github.hashgraph-online/hashnet is listed under Developer Tools MCP servers on MCPFind.

io.github.hashgraph-online/hashnet — MCP Server for Developer Tools

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

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-hashgraph-online-hashnet": {
      "command": "npx",
      "args": [
        "-y",
        "@hol-org/hashnet-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.hashgraph-online/hashnet works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.hashgraph-online/hashnet