> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shuriken.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect to Windsurf

> Step-by-step guide to connect your Shuriken Agent Key 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](https://windsurf.com) installed on your computer
* A Shuriken Agent Key ([create one here](/agent-kit/create-agent-key) if you haven't already)

## Step-by-step setup

<Steps>
  <Step title="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](/agent-kit/create-agent-key) - keys are only shown once.
  </Step>

  <Step title="Open the MCP config file">
    Windsurf stores its MCP config in a file called `mcp_config.json`.

    <Warning>
      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.
    </Warning>

    **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**

    <Tabs>
      <Tab title="Windows">
        ```
        %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.
      </Tab>

      <Tab title="macOS">
        ```
        ~/.codeium/windsurf/mcp_config.json
        ```
      </Tab>

      <Tab title="Linux">
        ```
        ~/.codeium/windsurf/mcp_config.json
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="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:

    ```json mcp_config.json theme={null}
    {
      "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:

    ```json mcp_config.json theme={null}
    {
      "mcpServers": {
        "your-existing-server": {
          "...": "..."
        },
        "Shuriken": {
          "serverUrl": "https://api.shuriken.trade/mcp",
          "headers": {
            "Authorization": "AgentKey YOUR_AGENT_KEY"
          }
        }
      }
    }
    ```

    <Warning>
      **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.
    </Warning>
  </Step>

  <Step title="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

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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.

    <Check>
      If you see results, you're all set. Windsurf is now connected to Shuriken.
    </Check>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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](https://app.shuriken.trade/agents)
  </Accordion>

  <Accordion title="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
    ```
  </Accordion>
</AccordionGroup>