Hedera Docs MCP Server Setup Guide

​

What Is the Hedera MCP Server?

• API references and SDK documentation
• Code examples and tutorials
• How-to guides and quickstarts
• Network concepts and architecture docs

​

MCP Server URL

https://docs.hedera.com/mcp

​

Why MCP Over Web Search?

​

Quick Install (One Command)

​

Setup by Tool

​

Claude (Web & Mobile)

1. Navigate to Customize → Connectors (or go directly to claude.ai/settings/connectors).
2. Click the ”+” button next to Connectors, then select “Add custom connector”.
3. Enter the details:
   • Name: Hedera Docs
   • URL: https://docs.hedera.com/mcp
4. Click Add.
5. In any chat, click the ”+” button in the lower left of the chat interface, then hover over “Connectors” to enable Hedera Docs for that conversation.

​

Claude Desktop

1. Click the ”+” button at the bottom of the chat box, then select “Connectors”.
2. If you haven’t added the Hedera connector yet, navigate to Settings → Developer → Connectors and click “Add custom connector”.
3. Enter the details:
   • Name: Hedera Docs
   • URL: https://docs.hedera.com/mcp
4. Click Add and restart Claude Desktop if prompted.

Note: Custom connectors added on Claude web (claude.ai) are also available in Claude Desktop and Claude mobile when signed in with the same account.

​

Claude Code

claude mcp add --transport http hedera-docs https://docs.hedera.com/mcp

claude mcp list

​

Cursor IDE

1. Press Cmd + Shift + P (macOS) or Ctrl + Shift + P (Windows/Linux).
2. Search for “Open MCP settings”.
3. Select Add custom MCP.
4. Add the following to mcp.json:

{
  "mcpServers": {
    "hedera-docs": {
      "url": "https://docs.hedera.com/mcp"
    }
  }
}

​

VS Code (GitHub Copilot)

1. Create the file .vscode/mcp.json in your project root.
2. Add the following configuration:

{
  "servers": {
    "hedera-docs": {
      "type": "http",
      "url": "https://docs.hedera.com/mcp"
    }
  }
}

3. In the Copilot chat panel, switch to Agent mode and restart the MCP server if prompted.

Note: VS Code uses a "servers" key (not "mcpServers") and requires a "type" field.

​

Windsurf IDE

1. Click the MCPs icon in the Cascade panel (top-right).
2. Browse or search for the Hedera MCP server and click Install.

1. Press Cmd + Shift + P (macOS) or Ctrl + Shift + P (Windows/Linux).
2. Search for “Open Windsurf Settings”.
3. Navigate to Cascade → MCP Servers or directly edit:

~/.codeium/windsurf/mcp_config.json

4. Add the following:

{
  "mcpServers": {
    "hedera-docs": {
      "serverUrl": "https://docs.hedera.com/mcp"
    }
  }
}

Note: Windsurf has a limit of 100 total tools across all connected MCP servers. You can toggle individual tools on/off per server.

​

ChatGPT

1. Open Settings → Apps (or Settings → Connectors in some UI versions).
2. Navigate to Advanced settings and toggle on Developer Mode.
3. Click Create to add a new app/connector.
4. Enter the details:
   • Name: Hedera Docs
   • Description: Search the official Hedera documentation.
   • URL: https://docs.hedera.com/mcp
5. Click Create.
6. In a new chat, click the ”+” button in the composer area, enable Developer Mode for the session, and select Hedera Docs.

Important: Developer Mode is required because without it, ChatGPT only accepts MCP servers that implement a specific search + fetch tool pattern. The Hedera MCP server exposes a SearchHedera tool, which requires Developer Mode to be accessible in chat. See the ChatGPT Developer Mode guide for details.

​

Gemini CLI

1. Open or create the Gemini CLI settings file:

~/.gemini/settings.json

2. Add the Hedera MCP server:

{
  "mcpServers": {
    "hedera-docs": {
      "url": "https://docs.hedera.com/mcp"
    }
  }
}

3. Launch Gemini CLI and verify with:

/mcp

Prerequisite: Install Gemini CLI with npm install -g @google/gemini-cli@latest.

​

Using Multiple MCP Servers

{
  "mcpServers": {
    "hedera-docs": {
      "url": "https://docs.hedera.com/mcp"
    },
    "another-docs": {
      "url": "https://example.com/docs/mcp"
    }
  }
}

• Connect only the servers relevant to your current work to keep context focused.
• Be specific in your prompts so the AI searches the most relevant server.
• MCP servers don’t consume context until the AI actively calls a search tool.
• Disconnect servers you’re not actively using to reduce context usage.

​

Configuration Reference

​

Troubleshooting

• Verify the URL is exactly https://docs.hedera.com/mcp (no trailing slash).
• Ensure you have an active internet connection.
• Restart your AI tool after adding the configuration.

• In Cursor/VS Code, click the refresh button next to the server entry.
• In Claude Code, run claude mcp list to verify the server is registered.
• In Windsurf, check the MCPs icon for server status — a red indicator means the connection failed.

• Try rephrasing your query with more specific Hedera terminology.
• Ensure the MCP server is enabled/active for your current chat session.

​

Additional Resources

• Model Context Protocol Specification
• Mintlify MCP Documentation
• Claude MCP Connectors
• Cursor MCP Docs
• VS Code MCP Servers
• Windsurf MCP Integration
• ChatGPT Developer Mode
• Gemini CLI MCP Setup
• Claude Code MCP Docs