Mirror Mirror

This MCP server provides a bridge between the Hedera Testnet Mirror Node API and an MCP client. It automatically exposes Mirror Node endpoints as MCP tools, with input validation and a FastMCP-based runtime, enabling you to query Hedera data through MCP transports.

How to use

You interact with the server by connecting an MCP client to its SSE-capable MCP interface. The server exposes tools that map to Hedera Mirror Node endpoints, automatically validating inputs and returning results. Note that while Server-Sent Events (SSE) transport is available on the server side, clients cannot connect to the MCP server using SSE transport for this setup.

How to install

Prerequisites: ensure you have a runtime capable of executing TypeScript directly, such as Bun.

Step 1: Clone the project

git clone https://github.com/hedera-dev/mirrornode-mcp-server

Step 2: Navigate to the project directory

cd mirrornode-mcp-server

Step 3: Install dependencies

npm install

Step 4: Start the MCP server

bun mcpServer.ts

Additional notes

Upon successful startup you should see a confirmation that the MCP server started. The server is exposed via an SSE endpoint, for example at the configured path such as http://localhost:3333/hedera-testnet-mirror-node-api/sse.

Configuration and behavior

What you need to know about how it works: the server creates an HTTP API client for the Hedera Testnet Mirror Node and then proxies those endpoints through the MCP transport. Endpoints are processed to ensure they use GET, parameters are validated against schemas, and results are returned to the MCP client.

Notes and tips

• If you require a local, file-based or process-driven execution, the server uses a standard runtime with necessary tooling such as FastMCP and Zod for validation.

• SSE is supported by the server but is not suitable for MCP client connections in this configuration; plan to use the MCP transport path provided by the server.

Available tools

createApiClient

Initializes an HTTP API client for the Hedera Testnet Mirror Node so MCP tools can invoke real API calls.

convertZodiosToMcp

Converts endpoint definitions from the OpenAPI-derived Zodios client into MCP tools, enforcing GET methods and parameter schemas.

startMcpServer

Boots the MCP server and exposes the MCP tools over the chosen transport (SSE in this case).