Integrations
Enables interaction with the Hedera network, providing tools for creating Hedera wallets, checking account balances, building cryptocurrency transfer transactions, and sending signed transactions to the Hedera blockchain.
Hedera MCP Server
A Model Context Protocol (MCP) server for interacting with the Hedera network. This server provides tools for creating Hedera wallets, checking account balances, building transactions, and sending signed transactions.
⚠️ Security Warning
This is a demo implementation and should NOT be used in production. The current implementation has several security vulnerabilities:
- Private keys are sent in response bodies
- No encryption of sensitive data
- No transaction verification mechanisms
This implementation is meant to demonstrate the MCP concept and should be properly secured before being used in a production environment.
Main Objectives
The primary purpose of this MCP server is to demonstrate how transaction construction and execution can be handled by the MCP server, with the client only needing to verify the transaction. Specifically:
- Transaction construction happens entirely on the MCP server
- Clients signs the constructed transactions
- The MCP server handles transaction submission to the Hedera network
- This architecture allows for centralized transaction logic and reduces client-side complexity
Prerequisites
- Node.js (v18 or higher)
- npm or yarn
- A Hedera account (for testnet or mainnet)
Installation
- Clone this repository:Copy
- Install dependencies:Copy
- Create a
.env
file in the root directory with your Hedera credentials:Copy
Building the Application
Compile the TypeScript code:
For development with automatic recompilation:
Running the Server
Start the server:
The server will be available at http://localhost:3000 (or the port specified in your .env file).
Testing with the Test Client
The repository includes a test client script that demonstrates how to connect to the MCP server and use its tools. This client provides a complete end-to-end flow demonstrating all available tools.
Run the test client:
The test client will:
- Connect to the MCP server
- List available tools
- Create a new Hedera wallet (create-wallet tool)
- Check the balance of the new account (check-balance tool)
- Build a transaction transferring the account's entire balance to the operator account (build-transaction tool)
- Sign the transaction on the client side using the Hedera SDK
- Submit the signed transaction to the Hedera network (send-transaction tool)
- Display the transaction result
This demonstrates the complete lifecycle of interacting with the Hedera network through the MCP server, from account creation to transaction submission.
Available MCP Tools
The server provides the following tools:
- create-wallet: Creates a new Hedera account with a minimal initial balance
- No input parameters required
- Returns account ID, public key, and private key
- check-balance: Checks the balance of a Hedera account
- Input:
accountId
(string) - Returns the account balance in tinybars
- Input:
- build-transaction: Builds a transfer transaction (without signing)
- Inputs:
senderAccountId
(string)recipientAccountId
(string)amount
(number, in tinybars)
- Returns a base64-encoded transaction
- Inputs:
- send-transaction: Sends a signed transaction to the Hedera network
- Input:
signedTransaction
(string, base64-encoded) - Returns transaction status and ID
- Input:
Deployment
A simple deployment script is included:
Make sure to make it executable first:
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that enables interactions with the Hedera network, providing tools for wallet creation, balance checking, transaction building, and sending signed transactions.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that provides Claude with comprehensive access to Solana blockchain data via the Helius API, enabling operations like checking wallet balances, retrieving blockchain information, and interacting with tokens and NFTs.Last updated -1198TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude AI to interact with the Solana blockchain through a standardized interface, providing tools for transactions, account queries, and wallet management.Last updated -5972Apache 2.0
- AsecurityAlicenseAqualityA Model Context Protocol server that connects Claude to Heurist Mesh APIs, providing access to various blockchain and web3 tools including cryptocurrency data, token security, Twitter intelligence, and web search capabilities.Last updated -1742PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server providing utility tools for development and testing, offering functionalities like personalized greetings, random card drawing, and datetime formatting with an extensible architecture.Last updated -191232TypeScriptMIT License