How do I install the hedera mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `HEDERA_NETWORK`, `HEDERA_OPERATOR_ID`, `HEDERA_MIRROR_URL`, `HEDERA_OPERATOR_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Hedera MCP Server

Build-only Hedera (Hashgraph) MCP — 51 tools across Account, HTS, HCS, EVM, File & Schedule.

Local serverstdioGo

What is the Hedera MCP Server?

Build-only Hedera (Hashgraph) MCP — 51 tools across Account, HTS, HCS, EVM, File & Schedule.

What you get

The official Hedera Agent Kit ships a preconfigured MCP server, but its tool surface is intentionally small (balance, transfer, deploy). This server fills the gap with end-to-end coverage of the Hedera API, organized for developer education and agent-driven onboarding — so a developer can go from "certified" to "shipping their first HTS token / HCS topic / contract" inside a single AI session.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Hedera MCP Server

{
  "mcpServers": {
    "hedera": {
      "command": "npx",
      "args": ["-y", "@purplesquirrel/hedera-mcp"],
      "env": {
        "HEDERA_NETWORK": "testnet",
        "HEDERA_OPERATOR_ID": "0.0.1234"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
HEDERA_NETWORK	Configuration value read at startup.	Optional
HEDERA_OPERATOR_ID	Configuration value read at startup.	Optional
HEDERA_MIRROR_URL	Endpoint or connection string the server talks to.	Yes
HEDERA_OPERATOR_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Hedera to Service.”
“Use Hedera to Account.”
“Use Hedera to File.”

Frequently asked questions

Build-only Hedera (Hashgraph) MCP — 51 tools across Account, HTS, HCS, EVM, File & Schedule. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Hedera MCP Server

Filesystem

Official

Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.

File Systems & StorageTypeScript★ 63.0k

Context7

Official

Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.

Documentation & API ReferencesRemoteTypeScript★ 32.0k

Wikimedia Image Search MCP

MCP server enabling AI assistants to search Wikimedia Commons images with metadata and visual previews

Developer ToolsGo

Sam'S Club Sponsored Ads APIs

MCP server for Sam's Club Sponsored Ads APIs

Developer ToolsPython

DevEnvInfoServer

Provides detailed information about your development environment to enhance code editor assistance.

Developer ToolsPython★ 7

Git Why

Finds the Git commits that explain why code is the way it is: semantic and full-text history search.

Developer Tools