Hedera Testnet Mirror Node MCP Server

@hedera-dev

Repository

Basic information

About Hedera Testnet Mirror Node MCP Server

Hedera MCP server

#mirrornode#mcp-server #hedera

Hedera Testnet Mirror Node MCP Server config

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

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

Hedera Testnet Mirror Node 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 Testnet Mirror Node MCP Server?

It is a Model Context Protocol (MCP) server that interfaces with the Hedera Testnet Mirror Node API. Built using FastMCP and Zod, it automatically converts Hedera Mirror Node API endpoints (defined in OpenAPI specification format) into MCP‑compatible tools.

How to use Hedera Testnet Mirror Node MCP Server?

Clone the repository, install dependencies with npm install, then start the server with bun mcpServer.ts. The server listens for SSE connections on http://localhost:3333/hedera-testnet-mirror-node-api/sse.

Key features of Hedera Testnet Mirror Node MCP Server

Automatic conversion of OpenAPI endpoints into MCP tools
Server‑Sent Events (SSE) transport support
Input validation using Zod schemas
Proxies between an HTTP API client and the MCP transport

Use cases of Hedera Testnet Mirror Node MCP Server

Querying Hedera testnet transaction and account data via AI assistants
Enabling MCP‑compatible agents to interact with the Hedera network
Building automated workflows that read mirror node state
Testing and prototyping Hedera applications with a natural‑language interface

Frequently asked questions

What dependencies are required?

Bun (or another TypeScript runtime) and npm. All library dependencies (FastMCP, Zod, openapi‑zod‑client) are installed via `npm install`.

How are API endpoints converted into tools?

The server uses `convertZodiosToMcp` to process GET endpoints defined in an OpenAPI specification. Each endpoint is mapped to a Zod schema and registered as an MCP tool that executes the corresponding API call.

Where does the server get its data?

All data comes from the Hedera Testnet Mirror Node API. The server acts as a proxy and does not store or cache any data locally.

What transport does the server use?

The server communicates via Server‑Sent Events (SSE) and exposes an SSE endpoint at the path `/hedera-testnet-mirror-node-api/sse`.

Does the server support mainnet?

No, the server is explicitly designed for the Hedera Testnet Mirror Node only, as indicated by its name and the API client configuration.

Comments

More Other MCP servers

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct