Skip to main content
Glama

Hedera MCP Server

by hedera-dev

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:

  1. Transaction construction happens entirely on the MCP server
  2. Clients signs the constructed transactions
  3. The MCP server handles transaction submission to the Hedera network
  4. 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

  1. Clone this repository:
    git clone https://github.com/hedera-dev/hedera-mcp-server.git cd hedera-mcp-server
  2. Install dependencies:
    npm install
  3. Create a .env file in the root directory with your Hedera credentials:
    HEDERA_OPERATOR_ID=your-operator-account-id HEDERA_OPERATOR_KEY=your-operator-private-key HEDERA_NETWORK=testnet # or mainnet PORT=3000 # optional, defaults to 3000

Building the Application

Compile the TypeScript code:

npm run build

For development with automatic recompilation:

npm run dev

Running the Server

Start the server:

npm start

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:

node test-client.js

The test client will:

  1. Connect to the MCP server
  2. List available tools
  3. Create a new Hedera wallet (create-wallet tool)
  4. Check the balance of the new account (check-balance tool)
  5. Build a transaction transferring the account's entire balance to the operator account (build-transaction tool)
  6. Sign the transaction on the client side using the Hedera SDK
  7. Submit the signed transaction to the Hedera network (send-transaction tool)
  8. 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:

  1. create-wallet: Creates a new Hedera account with a minimal initial balance
    • No input parameters required
    • Returns account ID, public key, and private key
  2. check-balance: Checks the balance of a Hedera account
    • Input: accountId (string)
    • Returns the account balance in tinybars
  3. build-transaction: Builds a transfer transaction (without signing)
    • Inputs:
      • senderAccountId (string)
      • recipientAccountId (string)
      • amount (number, in tinybars)
    • Returns a base64-encoded transaction
  4. send-transaction: Sends a signed transaction to the Hedera network
    • Input: signedTransaction (string, base64-encoded)
    • Returns transaction status and ID

Deployment

A simple deployment script is included:

./deploy.sh

Make sure to make it executable first:

chmod +x deploy.sh
-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. ⚠️ Security Warning
    1. Main Objectives
      1. Prerequisites
        1. Installation
          1. Building the Application
            1. Running the Server
              1. Testing with the Test Client
                1. Available MCP Tools
                  1. Deployment

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.
                      Last updated -
                      31
                      1
                      8
                      TypeScript
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that enables interaction with Foundry tools through natural language, allowing users to create projects, build contracts, run tests, and manage Ethereum development environments.
                      Last updated -
                      1
                      Python
                      MIT License
                    • A
                      security
                      F
                      license
                      A
                      quality
                      A Model Context Protocol server implementation that provides endpoints for wallet-based authentication, cluster management, and name registration services.
                      Last updated -
                      TypeScript
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A server that provides tools for interacting with MantraChain blockchain through the Model Context Protocol, allowing users to manage tokens, stake assets, query balances, and execute various blockchain operations.
                      Last updated -
                      18
                      83
                      2
                      TypeScript
                      MIT License

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/hedera-dev/hedera-mcp-server'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server