Hedera MCP Server

What is Hedera MCP Server?

It integrates with a Langchain wrapper to let users perform Hedera operations (token creation, HBAR transfers, smart contract interactions) through natural language commands, via the Model Context Protocol.

How to use Hedera MCP Server?

Clone the repository, copy .env.example into .env in both packages/langchain-proxy and packages/mcp-server, fill in required keys and tokens, install dependencies with pnpm install, then start the Langchain Proxy with pnpm run dev:lc and the MCP server with pnpm run dev:mcp. Configure your MCP client with the SSE endpoint and X-MCP-AUTH-TOKEN header.

Key features of Hedera MCP Server

• Natural language interaction with the Hedera network
• Integrates with Langchain wrapper for request interpretation
• SSE transport with token-based authentication
• Supports creating tokens, transferring HBAR, smart contracts

Use cases of Hedera MCP Server

• Create and manage Hedera tokens via chat commands
• Transfer HBAR using plain English instructions
• Query or invoke smart contracts on Hedera
• Automate Hedera operations through MCP-compatible tools

FAQ from Hedera MCP Server

What are the runtime requirements?

Node.js 20 or later, pnpm, Git, and valid Hedera network credentials (keys, network details) set in environment variables.

How does authentication work?

The server requires an X-MCP-AUTH-TOKEN header whose value must match one of the tokens defined in the MCP_AUTH_TOKEN environment variable. Unauthorized requests receive a 401 error.

Is the hedera-agent-kit package stable?

It is temporarily included from GitHub and has not been officially released yet, so it may change.

What transport does the server use?

It uses Server-Sent Events (SSE) via the GET /sse endpoint.

Does the server support OAuth?

As of March 2025, the official MCP OAuth specification exists but has limitations. The project references OAuth integration examples for future consideration but does not yet support it.