home / mcp / hedera mirror mcp server

Hedera Mirror MCP Server

Provides MCP tools generated from Hedera Testnet Mirror Node API endpoints with input validation and API proxying.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hedera-dev-mcp-server": {
      "command": "bun",
      "args": [
        "mcpServer.ts"
      ]
    }
  }
}

You run an MCP server that exposes the Hedera Mirror Node API as MCP tools. It proxies a Hedera HTTP API client into MCP so you can query Mirror Node data through MCP endpoints, with strong request validation and a focus on TypeScript tooling. This server is started via a simple runtime command and is designed to work with a client that understands MCP tools and SSE transport.

How to use

You connect to the MCP server using an MCP client that can operate with the generated tools. The server internally fetches data from the Hedera Testnet Mirror Node API and exposes the results as MCP tools derived from the API endpoints. Note that SSE transport is not available for clients, so you should interact with the MCP server through its MCP tools rather than attempting to connect via SSE.

Available tools

createApiClient

Creates an HTTP API client to interact with the Hedera Testnet Mirror Node API, forming the data source for MCP endpoint tools.

convertZodiosToMcp

Converts endpoints defined with Zod-based schemas into MCP tools, ensuring GET method usage, parameter schemas, execution function, and tool registration.

startMcpServer

Initializes and runs the MCP server, exposing the generated tools via the MCP transport.

mcpServerEntry

Entry point file mcpServer.ts that starts the MCP server and wires up the SSE proxy (where applicable) and the OpenAPI-to-MCP tooling.