Skip to main content
Service Maintenance

We are currently performing backend maintenance to enhance the MCP Server experience. Some features may be temporarily unavailable. We apologize for any inconvenience and appreciate your patience. Please check back soon for updates.

Claude Setup Guide

Claude provides native MCP support, making it the recommended platform for accessing Hedera blockchain data through natural language. With seamless integration across web, desktop, and mobile platforms, Claude delivers the most reliable and feature-rich experience for the Hgraph MCP Server.

Prerequisites​

Before setting up the MCP connector, you'll need:

  1. Hgraph API Key (Free)

    • Create an account at hgraph.com/hedera
    • Get your free API key from the dashboard
    • No credit card required for the free tier

  2. Claude Account

    • Claude Pro subscription required for custom connectors
    • Available at claude.ai
    • Claude Desktop app: Download here

Official Hgraph MCP URL​

Use this URL format with your API key:

https://mainnet.hedera.api.hgraph.io/v1/<YOUR-HGRAPH-API-KEY>/mcp

Replace <YOUR-HGRAPH-API-KEY> with your actual API key from the Hgraph dashboard.

Set up in Claude Web & Desktop​

Claude MCP Setup Screenshot - Shows the Connectors settings page with the Add custom connector dialog

  1. Sign in to Claude web or open Claude Desktop

  2. Click your profile icon (bottom left) and select "Settings"

  3. Navigate to the "Connectors" tab in the left sidebar

  4. Click "Add custom connector" button

  5. In the "Name" field, enter Hgraph (case-sensitive)

  6. In the "URL" field, paste your complete MCP URL with your API key:

    https://mainnet.hedera.api.hgraph.io/v1/<YOUR-HGRAPH-API-KEY>/mcp

  7. Click "Save connector" and you'll see Hgraph in your connectors list

How to use Hgraph MCP in Claude​

  1. Start a new chat and ensure the Hgraph connector is switched "on"
  2. Write prompts that specify Hedera data queries
  3. Claude automatically calls the appropriate Hgraph tools

Example prompt: "What is the current total supply of HBAR?"

Mobile Support

Once configured in Claude web or desktop, the Hgraph MCP will automatically appear in the Claude mobile app when signed into the same account.

Set Up in Claude Code CLI​

Claude Code provides the most powerful MCP experience for developers and technical users.

Claude Code MCP Setup Screenshot - Terminal showing the claude mcp add command

Installation Steps​

  1. Install Claude Code (installation guide)

  2. Complete any IDE-specific configurations

  3. Add the Hgraph MCP connector via terminal:

    claude mcp add --transport http hgraph https://mainnet.hedera.api.hgraph.io/v1/<YOUR-HGRAPH-API-KEY>/mcp

  4. Restart Claude Code:

    • VS Code: Reload window (Cmd/Ctrl+R)
    • Terminal: Exit and restart your session

  5. Verify the connection:

    claude mcp list

    You should see hgraph in the list of connected MCPs

How to use Hgraph MCP in Claude Code CLI​

Simply start a conversation and write prompts that specify Hedera data queries. Claude Code automatically calls the appropriate Hgraph tools.

Auto-approval Configuration

To avoid approving every Hgraph tool call, configure auto-approval by adding to your allowlist:

# Add Hgraph tools to auto-approval list
claude config set allowlist "mcp__hgraph__*"

Troubleshooting​

Connector not appearing​

  • Ensure you have an active Claude Pro subscription
  • Refresh the settings page
  • Try signing out and back in

Connection errors​

  • Verify your API key is correct
  • Check that the URL format matches exactly
  • Ensure your Hgraph API key is active

Claude Code issues​

  • Make sure Claude Code is fully restarted after adding the connector
  • Verify the connector appears in claude mcp list
  • Check that your terminal has internet access

Next Steps​

Need help? Visit our support page or join our Discord community