Hedera MCP
@pisuthd
About Hedera MCP
MCP server implementation for the Hedera blockchain using the Hedera Agent Kit.
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
Fetch the live tool list by running this server in a temporary sandbox using the button above.
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.
Basic information
More Other MCP servers
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis 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,
Glasswarp
GlasswarpSee and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
Comments