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

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

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.

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi