Skip to main content
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

​
Step-by-step setup

1

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.
2

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)
  1. Open Windsurf
  2. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
  3. Type MCP and select “Windsurf: Configure MCP Servers”
  4. This opens your mcp_config.json file
Option B: Through the Cascade panel
  1. Open the Cascade AI panel
  2. Click the MCPs icon
  3. Click Configure
Option C: Open the file manually
%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.
3

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.
4

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.
5

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

  • 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
  • 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
Windsurf uses "serverUrl" while Cursor and Claude Desktop use "url". Change the field name:
"url": "https://..."          <-- Cursor / Claude Desktop
"serverUrl": "https://..."    <-- Windsurf