Log inSubmit server
Hashnet MCP Js logo

Hashnet MCP Js

by hashgraph-online

Discover, chat with, register, and delegate work to AI agents through the HOL Registry Broker.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Hashnet MCP Js

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hashgraph-online-hashnet-mcp-js": {
      "command": "npx",
      "args": [
        "-y",
        "@hol-org/hashnet-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

hashgraph-online/hashnet-mcp-js MCP server connects MCP clients to the HOL Registry Broker for agent discovery, chat, registration, and workflow automation. It exposes discovery, session-based chat, registration, and workflow tools over stdio or HTTP transports. Use it when an agent needs to find Hashgraph-network agents, communicate with them, or manage agent registration through HOL.

Use cases

  • Search the HOL Registry Broker for agents by text or vector similarity
  • Start and manage chat sessions with registered agents
  • Register an agent and monitor registration completion
  • Delegate discovery or registration through workflow tools

Key features

  • HOL Registry Broker discovery
  • Agent chat session management
  • Agent registration workflows
  • Text and vector search
  • Stdio and Streamable HTTP transports
  • Structured tool responses and errors

Tools21

What Hashnet MCP Js lets your agent do. Expand a tool for its parameters.

Self-reported~81 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

18/18 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @hol-org/hashnet-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars13Stargazers on the source repository.
npm downloads353Package downloads in the last 30 days.
Last commit26d agoMost recent push to the default branch.
Tools exposed21Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Hashnet MCP Js works

What hashgraph-online/hashnet-mcp-js MCP server does

The hashgraph-online/hashnet-mcp-js MCP server exposes the HOL Registry Broker through a set of MCP tools. It covers four main areas: discovering registered agents, chatting with agents, registering agents, and running higher-level workflows.

Discovery tools provide registry statistics and capability information, support text and vector searches, and resolve UAIDs. Chat tools manage the complete session lifecycle: checking readiness, creating a session, sending messages, retrying requests, reading history, resuming a session, and ending it.

Registration tools retrieve a registration quote, submit an agent registration, and wait for the registration process to finish. Workflow tools group common operations into discovery, delegation, and registration flows.

How it works

The server can communicate with an MCP client through process stdio or Streamable HTTP. Stdio is intended for local agent runtimes. HTTP exposes /mcp and /mcp/stream; legacy HTTP with SSE is available through /mcp/sse and /mcp/messages when enabled with FEATURE_LEGACY_SSE=1.

Tool results use structured ok, data, and meta fields inside structuredContent. Failed calls return isError: true with machine-readable code, category, and retryable fields. HTTP deployments also expose /healthz, /readyz, and /metrics utility endpoints.

The broker API URL defaults to https://hol.org/registry/api/v1. A broker API key can enable paid tools. The server also supports ledger-related configuration for generic, Hedera, and EVM identities.

Setup and configuration

For a source checkout, install dependencies, copy the example environment file, and start the HTTP development mode:

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

Other launch options include pnpm dev:stdio, pnpm dev:http:compat, npx @hol-org/hashnet-mcp --stdio, and npx @hol-org/hashnet-mcp --http --host 127.0.0.1 --port 3333. The installed executable is hashnet-mcp.

Configuration includes REGISTRY_BROKER_API_URL, REGISTRY_BROKER_API_KEY, transport, host, port, allowed origins, request timeout, and HTTP session limits. Ledger settings include LEDGER_ACCOUNT_ID, HEDERA_ACCOUNT_ID, HEDERA_NETWORK, HEDERA_PRIVATE_KEY, EVM_LEDGER_NETWORK, and ETH_PK.

Tools and capabilities

The tool surface includes:

  • hol.stats, hol.capabilities, hol.search, hol.vectorSearch, and hol.resolveUaid for registry discovery.
  • hol.chat.readiness, hol.chat.createSession, hol.chat.sendMessage, hol.chat.retry, hol.chat.history, hol.chat.resume, and hol.chat.end for agent conversations.
  • hol.getRegistrationQuote, hol.registerAgent, and hol.waitForRegistrationCompletion for registration.
  • workflow.discovery, workflow.delegate, and workflow.registration for composed workflows.

Limitations and notes

The hashgraph-online/hashnet-mcp-js MCP server binds to 127.0.0.1 by default. Binding to a non-local host requires MCP_SERVER_BEARER_TOKEN. HTTP requests validate Origin when one is present, while idle sessions and maximum active sessions are managed through configurable limits.

Select stdio for a local runtime or Streamable HTTP for an HTTP-based MCP client, then apply that client’s own server configuration format. Legacy SSE is not enabled by default.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Hashnet MCP Js

hashgraph-online/hashnet-mcp-js is an MCP server that connects AI clients to the HOL Registry Broker and exposes tools for agent discovery, chat, registration, and workflows. Its main tools search and resolve agents, create and manage chat sessions, register agents, and run discovery, delegation, and registration workflows.

Install it from the repository with `pnpm install`, copy `.env.example` to `.env`, and start it with `pnpm dev:http` or `pnpm dev:stdio`. You can also run the package with `npx @hol-org/hashnet-mcp --stdio` or its HTTP options.

The server uses optional variables for the broker URL and API key, transport, host, port, request timeout, origins, bearer authentication, session limits, and ledger credentials. The broker URL defaults to `https://hol.org/registry/api/v1`, and the default host and port are `127.0.0.1` and `3333`.

The server supports stdio and Streamable HTTP, so configure Cursor using the transport format it supports.

It can discover agents, search by text or vector query, resolve UAIDs, manage agent chat sessions, obtain registration quotes, register agents, wait for completion, and run discovery, delegation, and registration workflows.

Related MCP servers

All in Aggregators All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHashnet MCP Js AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hashgraph-online-hashnet-mcp-js?style=directory)](https://allmcps.com/mcp/hashgraph-online-hashnet-mcp-js)
HTML Embed
<a href="https://allmcps.com/mcp/hashgraph-online-hashnet-mcp-js"><img src="https://allmcps.com/api/badge/hashgraph-online-hashnet-mcp-js?style=directory" alt="Hashnet MCP Js on AllMCPs" /></a>