Connect to Windsurf

This guide gets Windsurf connected to Shuriken in about 2 minutes. Once set up, you can ask Cascade to scan alpha, research tokens, check your portfolio, and trade - all from the chat panel. Time required: About 2 minutes.

Prerequisites

Windsurf installed on your computer
A Shuriken Agent Key (create one here if you haven’t already)

Step-by-step setup

Copy your Agent Key

If you just created your key, copy it from the setup screen. It starts with sk_.If you already closed that screen, you’ll need to create a new key - keys are only shown once.

Open the MCP config file

Windsurf stores its MCP config in a file called mcp_config.json.

Windsurf uses a different config file and format than Cursor and Claude Desktop. Don’t copy configs from those tools directly - the key name for the URL field is different.

Option A: Use the Command Palette (recommended)

Open Windsurf
Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
Type MCP and select “Windsurf: Configure MCP Servers”
This opens your mcp_config.json file

Option B: Through the Cascade panel

Open the Cascade AI panel
Click the MCPs icon
Click Configure

Option C: Open the file manually

Windows
macOS
Linux

%USERPROFILE%\.codeium\windsurf\mcp_config.json

Press Win+R, paste %USERPROFILE%\.codeium\windsurf and hit Enter. Look for mcp_config.json. If it doesn’t exist, create it.

~/.codeium/windsurf/mcp_config.json

~/.codeium/windsurf/mcp_config.json

Add the Shuriken server

Paste the following into your mcp_config.json file. Replace YOUR_AGENT_KEY with the key you copied in step 1.If the file is empty or doesn’t exist, paste this entire block:

mcp_config.json

{
  "mcpServers": {
    "Shuriken": {
      "serverUrl": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}

If you already have other MCP servers, add the "Shuriken" block inside the existing "mcpServers" object:

mcp_config.json

{
  "mcpServers": {
    "your-existing-server": {
      "...": "..."
    },
    "Shuriken": {
      "serverUrl": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}

Important: Windsurf uses "serverUrl" (not "url"). If you copy config from the Cursor or Claude Desktop guides, make sure to change "url" to "serverUrl" or the connection will fail silently.

Save and refresh

Save the file. In Windsurf, you can either:

Restart Windsurf completely, or
Click the refresh button next to the MCPs section in the Cascade panel

Unlike Cursor and Claude Desktop, Windsurf can sometimes pick up config changes without a full restart. But if it doesn’t work, restart to be safe.

Verify the connection

Open a chat in the Cascade panel and try one of these prompts:

What tokens were called in my Discord today?

What's my SOL balance?

If Shuriken is connected, Cascade will use Shuriken tools to answer your question.

If you see results, you’re all set. Windsurf is now connected to Shuriken.

Troubleshooting

Cascade doesn't show Shuriken tools

Make sure you saved the mcp_config.json file
Try clicking the refresh button in the Cascade panel
If that doesn’t work, fully restart Windsurf
Check that there are no JSON syntax errors

Tools show up but return errors

Double-check that your Agent Key is correct (starts with sk_)
Make sure you’re using "serverUrl" (not "url")
Make sure you included the AgentKey prefix before the key (with a space)
Check that the key hasn’t been revoked on the Agent Keys dashboard

Copied config from Cursor/Claude but it's not working

Windsurf uses "serverUrl" while Cursor and Claude Desktop use "url". Change the field name:

"url": "https://..."          <-- Cursor / Claude Desktop
"serverUrl": "https://..."    <-- Windsurf

​Prerequisites

​Step-by-step setup

​Troubleshooting

Prerequisites

Step-by-step setup

Troubleshooting