Hedera MCP

Name: Hedera MCP
Author: pisuthd

@pisuthd

Repository Homepage

About Hedera MCP

MCP server implementation for the Hedera blockchain using the Hedera Agent Kit.

#mcp #blockchain #claude #hedera #ai-agent #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hedera": {
      "command": "npx",
      "args": [
        "-y",
        "hedera-mcp",
        "--hedera_account_id=0.0.XXXXX",
        "--hedera_private_key=YOUR_PRIVATE_KEY",
        "--hedera_network=testnet"
      ],
      "disabled": false
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Hedera MCP?

Hedera MCP is a Model Context Protocol (MCP) server implementation for the Hedera blockchain, built using the Hedera Agent Kit. It allows AI models that support MCP to interact with the Hedera network and perform a wide range of blockchain operations without needing to write code.

How to use Hedera MCP?

Hedera MCP works with MCP‑compatible clients like Claude Desktop. Add it to your Claude Desktop configuration with a command like npx -y hedera-mcp --hedera_account_id=0.0.XXXXX --hedera_private_key=YOUR_PRIVATE_KEY --hedera_network=testnet. You can also run it standalone with npx hedera-mcp.

Key features of Hedera MCP

15+ MCP tools covering account, token, and distribution operations
Non‑custodial setup (no private keys exposed on any server)
Compatible with MCP clients like Claude Desktop
Enables AI to automate tasks both within and outside Web3
Simple configuration and standalone execution

Use cases of Hedera MCP

Retrieve HBAR or token balances for any Hedera account
Create and mint fungible or non‑fungible tokens (NFTs)
Transfer HBAR or tokens between accounts
Manage token associations, dissociations, and rejections
Create and claim token airdrops to multiple accounts

FAQ from Hedera MCP

How do I set up Hedera MCP with Claude Desktop?

Add a hedera entry in your Claude Desktop MCP configuration with the npx command and your Hedera account ID, private key, and network (testnet or mainnet). Restart Claude Desktop after changing the configuration.

What dependencies or runtime are required?

Hedera MCP runs via npx (Node.js) and requires no additional installation. Your Hedera account must have sufficient HBAR balance for transactions.

Where does my private key and account data live?

The setup is non‑custodial: your private key is passed only as a command‑line argument to the local MCP server; it is never exposed on a remote server. All data operations occur on the Hedera blockchain.

What transports or authentication does the server use?

Hedera MCP connects to Claude Desktop via the standard MCP stdio transport. Authentication to the Hedera network is done using the provided account ID and private key.

What should I do if I encounter errors?

Verify your account ID and private key are correct, confirm your account has sufficient HBAR, ensure the network parameter (testnet/mainnet) is correct, and restart Claude Desktop after configuration changes. Check console output for detailed error messages.

Comments

More Other MCP servers

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K