Connect Hive to Windsurf

Connect Windsurf to Hive so Cascade can call live crypto tools from your editor. Add the remote MCP server to mcp_config.json, restart Windsurf, then verify a Hive price query.

Before you start

1. Windsurf installed from codeium.com/windsurf.
2. A Hive API key from /dashboard/keys.

Configure Windsurf

1. Open the MCP config file

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Create the file if it doesn't exist.

2. Add this config

{
  "mcpServers": {
    "hive": {
      "serverUrl": "https://mcp.hiveintelligence.xyz/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_HIVE_API_KEY"
      }
    }
  }
}

Replace YOUR_HIVE_API_KEY with the key from /dashboard/keys.

Windsurf's current MCP docs use serverUrl for remote servers. Hive connects directly over Streamable HTTP, so there is no local Node subprocess in the default path.

Local stdio server

If your Windsurf build does not support remote MCP yet, or you want to supply upstream provider credentials directly, use stdio instead:

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "-p", "hive-intelligence@latest", "hive"]
    }
  }
}

Windsurf starts npx -y -p hive-intelligence@latest hive as a self-hosted MCP process. Local stdio does not use HIVE_API_KEY; add provider-specific variables to env only when needed.

3. Restart Windsurf

Quit Windsurf fully and reopen. Cascade will pick up the Hive MCP server on launch.

4. Verify it worked

Open Cascade (⌘L on macOS) and ask:

"Using the Hive MCP server, what is the current price of BTC and ETH?"

Cascade should call Hive's get_price tool and return live data.

What to ask in Windsurf

• "Write a Python script that pulls top DeFi yields from Hive and posts a daily summary to Slack."
• "Check this contract address for security issues before I deploy code that calls it: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
• "Build me a Next.js API route that returns the current BTC funding rate from supported exchanges."
• "Given this wallet address, show me current holdings and 24h P&L, then generate the fetch code."

Cascade mixes Hive tool calls with code generation, and the agent picks the right tool per step.

Troubleshooting

Cascade doesn't list Hive. Confirm ~/.codeium/windsurf/mcp_config.json exists and is valid JSON. Restart Windsurf.

"npx: command not found". Install Node.js 22.12 or newer from nodejs.org, then restart Windsurf.

API key rejected. Verify at /dashboard/keys; keys are whitespace-sensitive.

Other clients

• Cursor: similar IDE, wider MCP ecosystem.
• VS Code: for GitHub Copilot Chat users.
• All clients: full list.

Next steps

• Agent Resources: what Cascade can build once connected.
• Tools Reference: every tool Cascade can call.