Hedera MCP
GitHub

Fully Functional MCP for Hedera

Enables AI assistants that support the Model Context Protocol to become fully functional Web3 agents, allowing them to create tokens, transfer assets, and interact with Hedera.

Get Started

Install an MCP-compatible client such as Claude Desktop:

On Ubuntu
# Clone the repository
git clone https://github.com/aaddrick/claude-desktop-debian.git
cd claude-desktop-debian
 
# Build the package
./build.sh

Then configure Claude Desktop to use Hedera MCP:

Claude Desktop Configuration
{
  "mcpServers": {
    "hedera": {
      "command": "npx",
      "args": [
        "-y",
        "hedera-mcp",
        "--hedera_account_id=YOUR_ACCOUNT_ID",
        "--hedera_private_key=YOUR_PRIVATE_KEY",
        "--hedera_network=testnet"
      ],
      "disabled": false
    }
  }
}

Available MCP Tools

  • Account Operations4 Tools
  • Token Operations7 Tools
  • Token Distribution Tools4 Tools
  • Search & Analytics1 Tools

Supported Networks

  • Hedera Testnet
  • Hedera Mainnet

Use Cases

  • 🎮
    NFT & Digital Collectibles
  • 💸
    Token-Based Loyalty Programs
  • 🏛️
    DAO Governance & Treasury
  • 🔄
    DeFi & Tokenized Assets

Conversational examples

ME

help send 0.5 HBAR to account 0.0.4299366?

AI

I'll help you send 0.5 HBAR to account 0.0.4299366. Let me execute that transaction for you.

ME

suggest how we can Create fungible tokens on Hedera?

AI

I'd be happy to suggest how you can create fungible tokens on Hedera! Here's a step-by-step approach: 1. Choose a token name and symbol (e.g., MyToken and MTK) 2. Determine the number of decimal places (typically 2-18) 3. Decide on an initial supply

ME

help check my current HBAR balance ?

AI

I've checked your account, and your current HBAR balance is 95.99261739 HBAR. This reflects the 1 HBAR transfer you just made to account 0.0.4299366, plus the transaction fee that was deducted when processing the transfer.