Hedera MCP Server

What is Hedera MCP Server?

It integrates a Langchain wrapper to interact with the Hedera network, allowing users to perform Hedera operations through natural language commands. Designed for developers building LLM-powered applications that need to create tokens, transfer HBAR, or interact with smart contracts.

How to use Hedera MCP Server?

Clone the repository, set environment variables in packages/langchain-proxy and packages/mcp-server, then run pnpm install. Start the Langchain proxy service with pnpm run dev:lc, then start the MCP server with pnpm run dev:mcp. Configure the client to connect via SSE at the server’s URL, providing the X-MCP-AUTH-TOKEN header with a token listed in MCP_AUTH_TOKEN.

Key features of Hedera MCP Server

• Perform Hedera operations via natural language commands
• SSE transport with token-based authentication
• Supports token creation, HBAR transfers, smart contract interaction
• Two-service architecture: Langchain proxy and MCP server
• Configurable via environment variables

Use cases of Hedera MCP Server

• Build LLM apps that manage Hedera accounts and tokens
• Automate Hedera operations through conversational interfaces
• Integrate Hedera functionality into AI assistants
• Prototype decentralized applications with natural language queries

FAQ from Hedera MCP Server

What is the architecture of Hedera MCP Server?

It consists of two services: a Langchain proxy that interprets natural language requests, and an MCP server that provides the MCP interface and routes to the proxy.

How does authentication work?

The MCP server requires an X-MCP-AUTH-TOKEN header with a value matching one of the tokens listed in the MCP_AUTH_TOKEN environment variable.

What transport protocol does the MCP server use?

It uses Server-Sent Events (SSE) as the transport (endpoint: /sse).

What are the runtime requirements?

Node.js version 20 or later, the pnpm package manager, and Git. Environment variables must be configured in two package directories.

Are there any known limitations with client IDEs?

Custom HTTP headers (such as X-MCP-AUTH-TOKEN) are not currently supported in Cursor IDE, though support is expected in future versions.