Hive Intelligence home
Hive Intelligence
GitHub

Install in Your AI Client

Connect Hive to Windsurf

Add Hive to Windsurf and Codeium's Cascade agent can query live crypto data while you code.

Before you start

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

30-second setup

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. Paste this config

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

Replace YOUR_HIVE_API_KEY with the key from /dashboard/keys.

Why the env var and not a header? This is the stdio transport — Windsurf spawns npx -y hive-intelligence@latest as a local subprocess and hands it the key via the environment. The local wrapper then forwards every upstream request to mcp.hiveintelligence.xyz with Authorization: Bearer YOUR_HIVE_API_KEY attached. The env var is just how the wrapper receives the secret; Hive's server sees the same Bearer token it would get from any HTTP-direct client.

If your Windsurf build supports remote streamable-HTTP MCP and you'd rather skip the local Node wrapper, point Cascade at https://mcp.hiveintelligence.xyz/mcp with an Authorization: Bearer header — the exact config key varies between Windsurf releases, so check Windsurf's MCP docs for the current remote-server shape.

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: 0x..."
  • "Build me a Next.js API route that returns the current BTC funding rate from every major exchange."
  • "Given this wallet address, show me current holdings and 24h P&L — generate the fetch code."

Cascade mixes Hive tool calls with code generation — 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 18+ from nodejs.org, then restart Windsurf.

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

Other clients

Next steps

Previous
Cursor
Next
VS Code