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

# Windsurf / Cascade

> Connect Windsurf / Cascade to Dreamtune MCP and install scoped workflow skills.

<img src="https://mintcdn.com/dreamtune/alDlJCy5wJhi5BBd/images/agents/windsurf.ico?fit=max&auto=format&n=alDlJCy5wJhi5BBd&q=85&s=9bf1248fa7aab815ab997c0229141dd0" alt="Windsurf / Cascade official logo" width="48" height="48" data-path="images/agents/windsurf.ico" />

## Before you connect

Create a Dreamtune workspace API key with only the permissions you need.
Hosted HTTP setup needs no Dreamtune package installation. Local stdio setup
requires Node.js 22.20 or later and the published CLI.

## Configure

Merge this server entry into the file opened by Cascade's Open MCP config file action. Preserve any other servers or settings.

```json theme={null}
{
  "mcpServers": {
    "dreamtune": {
      "command": "dreamtune",
      "args": ["mcp"],
      "env": {
        "DREAMTUNE_API_KEY": "YOUR_DREAMTUNE_KEY",
        "DREAMTUNE_API_ORIGIN": "https://dreamtune-api.fly.dev",
        "DREAMTUNE_REQUEST_TIMEOUT_MS": "135000"
      }
    }
  }
}
```

Install @dreamtune/sdk globally first. Replace YOUR\_DREAMTUNE\_KEY only in your private client settings. The current vendor documentation redirects to Devin Desktop; configuration paths vary by installed generation. Use the editor's config action instead of assuming an old path. This guide uses its documented local stdio format.

## Verify the connection

Restart the client after changing settings or its environment. Open its MCP
server/tool status view and check that Dreamtune tools are listed. Ask it:

> Use Dreamtune to read model request limits. Do not execute a model, tool or GPU.

Confirm model\_limits returns limits before authorizing paid work. Then inspect a
catalog schema and use one explicitly approved operation. Keep client approval
controls enabled. Never put the key in a chat message, URL or repository.

## Add workflow instructions

Install the [Dreamtune skills](/connect/skills-install) into the skills directory
supported by your client, or copy the platform skill into a user instruction
workflow. A skill guides the agent; MCP provides execution. Neither grants extra
key permissions. See [troubleshooting](/errors) for 401, missing scopes, timeouts
and key/environment problems.

Configuration verified against [the official client documentation](https://docs.devin.ai/desktop/cascade/mcp).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.