Skip to content
MCP server

Hedera Hcs MCP Server

AI-powered Hedera HCS topic intelligence for agents. Pay per call in HBAR.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.1
Listing updated
4 days ago

About Hedera Hcs MCP Server

Hedera Hcs MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add hedera-hcs-mcp-server --env HEDERA_ACCOUNT_ID='<HEDERA_ACCOUNT_ID>' --env HEDERA_PRIVATE_KEY='<HEDERA_PRIVATE_KEY>' --env HEDERA_NETWORK='<HEDERA_NETWORK>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y hedera-hcs-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hedera-hcs-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hedera-hcs-mcp-server"
      ],
      "env": {
        "HEDERA_ACCOUNT_ID": "<HEDERA_ACCOUNT_ID>",
        "HEDERA_PRIVATE_KEY": "<HEDERA_PRIVATE_KEY>",
        "HEDERA_NETWORK": "<HEDERA_NETWORK>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hedera-hcs-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hedera-hcs-mcp-server"
      ],
      "env": {
        "HEDERA_ACCOUNT_ID": "<HEDERA_ACCOUNT_ID>",
        "HEDERA_PRIVATE_KEY": "<HEDERA_PRIVATE_KEY>",
        "HEDERA_NETWORK": "<HEDERA_NETWORK>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "hedera-hcs-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hedera-hcs-mcp-server"
      ],
      "env": {
        "HEDERA_ACCOUNT_ID": "<HEDERA_ACCOUNT_ID>",
        "HEDERA_PRIVATE_KEY": "<HEDERA_PRIVATE_KEY>",
        "HEDERA_NETWORK": "<HEDERA_NETWORK>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hedera-hcs-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hedera-hcs-mcp-server"
      ],
      "env": {
        "HEDERA_ACCOUNT_ID": "<HEDERA_ACCOUNT_ID>",
        "HEDERA_PRIVATE_KEY": "<HEDERA_PRIVATE_KEY>",
        "HEDERA_NETWORK": "<HEDERA_NETWORK>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hedera-hcs-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hedera-hcs-mcp-server"
      ],
      "env": {
        "HEDERA_ACCOUNT_ID": "<HEDERA_ACCOUNT_ID>",
        "HEDERA_PRIVATE_KEY": "<HEDERA_PRIVATE_KEY>",
        "HEDERA_NETWORK": "<HEDERA_NETWORK>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Configuration

  • HEDERA_ACCOUNT_IDHedera account ID in format 0.0.XXXXXXXRequired
  • HEDERA_PRIVATE_KEYHedera account private key (ECDSA hex format)Required
  • HEDERA_NETWORKHedera network: testnet or mainnetRequired
  • OPENAI_API_KEYOpenAI API key for GPT-4o Mini powered analysisRequired

Pricing

Open source

Hedera Hcs MCP Server FAQ

Is Hedera Hcs MCP Server free?

Yes. Hedera Hcs MCP Server is open source, so you can use and self-host it for free.

How do I add Hedera Hcs MCP Server to Claude Code?

Run this command in your terminal: claude mcp add hedera-hcs-mcp-server --env HEDERA_ACCOUNT_ID='<HEDERA_ACCOUNT_ID>' --env HEDERA_PRIVATE_KEY='<HEDERA_PRIVATE_KEY>' --env HEDERA_NETWORK='<HEDERA_NETWORK>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y hedera-hcs-mcp-server