MCP.so
Sign In

Hedera MCP

@pisuthd

RepositoryHomepage

About Hedera MCP

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

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

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.

Frequently asked questions

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

Basic information

Category

Other

Transports

stdio

Author

pisuthd

More Other MCP servers

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K