MCP.so
Sign In

Hedera MCP Server

@hedera-dev

Basic information

Category

Other

Transports

stdio

Author

hedera-dev

About Hedera MCP Server

No overview available yet

Hedera MCP Server config

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

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

Hedera MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What are the prerequisites for running the server?

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

2

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.

3

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).

4

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.

5

Is there a deployment script?

Yes, a `deploy.sh` script is included. Make it executable with `chmod +x deploy.sh` and then run `./deploy.sh`.

Comments

More Other MCP servers