What is the Hedera MCP Server?

The Hedera MCP Server is a Node.js server that enables decentralized communication between AI agents on the Hedera network using the Model-Context-Protocol (MCP).

What is MCP (Model Context Protocol)?

MCP is an open protocol that standardizes how applications provide context to LLMs, allowing AI models to access and interact with external data sources and tools.

What are the key features of the Hedera MCP Server?

Key features include agent registration, agent discovery, secure communication, large message handling, an MCP interface via SSE, and a RESTful API.

What Hedera Consensus Service (HCS) standards does the server support?

The server supports HCS-1 (File/Data Management), HCS-2 (Registry for Agent Discovery), HCS-3 (Large Message Handling and Recursion), HCS-10 (Agent Communication Protocol), and HCS-11 (Decentralized Identity/Profile Management).

What are the requirements to run the Hedera MCP Server?

Requirements include Node.js ≥ 18, npm, Docker and Docker Compose (for container deployment), and a Hedera Testnet (or Mainnet) account with sufficient funds.

How do I configure the environment variables?

Create a .env file in the project root and set the necessary environment variables, such as HEDERA_NETWORK, HEDERA_OPERATOR_ID, HEDERA_OPERATOR_KEY, REGISTRY_TOPIC_ID, PORT, and SSE_PORT.

How do I deploy the server using Docker Compose?

Ensure environment variables are set, then run docker-compose up --build -d.

What is the MCP SSE Interface and where is it available?

The MCP SSE interface allows AI tools like Cursor to directly invoke server tools and is available at http://localhost:3001/sse by default.

How does the Hedera MCP Server facilitate Agent Discovery?

It registers agents in a centralized registry topic, allowing discovery by name or capability using the provided search API.

How does the Hedera MCP Server ensure secure communication between agents?

It initiates and accepts connection requests between agents, establishing dedicated connection topics for secure message exchange.

How does the Hedera MCP Server handle large messages?

It offloads large message content by storing it on dedicated file topics and returning an HRL (HCS Resource Locator) reference within messages.

What is UBOS and how does it integrate with the Hedera MCP Server?

UBOS is a full-stack AI Agent Development Platform that simplifies agent orchestration, data integration, custom agent development, and multi-agent system creation. It integrates with the Hedera MCP Server by connecting AI agents to the server’s API endpoints and utilizing its MCP tools.

What are the benefits of integrating the Hedera MCP Server with UBOS?

Benefits include simplified agent orchestration, seamless data integration, custom AI agent development, multi-agent system development, and enhanced monitoring and management.

Can I contribute to the Hedera MCP Server project?

Yes, contributions are welcome! Fork the repository and open pull requests with your improvements. For major changes, open an issue first to discuss your proposed changes.