Hedera MCP Server

Name: Hedera MCP Server
Author: hedera-dev

@hedera-dev

Repository

About Hedera MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hedera-mcp-server": {
      "command": "node",
      "args": [
        "test-client.js"
      ]
    }
  }
}

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 Server?

A Model Context Protocol (MCP) server for interacting with the Hedera network. It provides tools for creating Hedera wallets, checking account balances, building transactions, and sending signed transactions.

How to use Hedera MCP Server?

Requires Node.js v18 or higher, npm/yarn, and a Hedera account. Clone the repository, install dependencies, create a .env file with your operator credentials (HEDERA_OPERATOR_ID, HEDERA_OPERATOR_KEY, HEDERA_NETWORK), build the TypeScript code, and start the server. A test client script (test-client.js) demonstrates the complete workflow: create-wallet, check-balance, build-transaction, sign client-side, and send-transaction.

Key features of Hedera MCP Server

Create a new Hedera account with a minimal initial balance
Check the balance of any Hedera account in tinybars
Build an unsigned transfer transaction (returns base64-encoded)
Send a client-signed transaction and return status and ID
Complete end-to-end test client demonstrating all tools

Use cases of Hedera MCP Server

Create Hedera wallets programmatically via AI assistants
Check account balances without direct SDK integration
Build and send transfer transactions through conversational interfaces
Integrate Hedera network operations into AI-powered workflows

FAQ from Hedera MCP Server

What are the prerequisites for running the server?

Node.js v18 or higher, npm or yarn, and a Hedera account (testnet or mainnet).

How do I configure the server to connect to Hedera?

Create a .env file with HEDERA_OPERATOR_ID, HEDERA_OPERATOR_KEY, and HEDERA_NETWORK (testnet or mainnet). An optional PORT defaults to 3000.

What tools does the server expose?

Four tools: create-wallet (no inputs), check-balance (requires accountId), build-transaction (requires senderAccountId, recipientAccountId, amount in tinybars), and send-transaction (requires signedTransaction as base64 string).

How can I test the server?

Run node test-client.js after starting the server. It connects, lists tools, creates a wallet, checks balance, builds a transaction, signs it client-side, sends it, and displays the result.