Skip to content

AI clients

CueScout in Windsurf

Windsurf keeps its MCP servers in a single config under ~/.codeium, and Cascade picks up the tools once it reloads them. The setup is the same shape as every other client; the file lives somewhere different. Runs @cuescout/mcp through npx, so there is nothing to install first.

Where the config lives
~/.codeium/windsurf/mcp_config.json

Setting it up

3 steps, and the last one proves it works.

  1. Open the MCP config

    Cascade's settings panel has a link to it, or edit ~/.codeium/windsurf/mcp_config.json directly. It uses the standard mcpServers shape.

  2. Add the server block

    Add the entry inside any existing mcpServers object rather than adding a second one.

    ~/.codeium/windsurf/mcp_config.json

    {
      "mcpServers": {
        "cuescout": {
          "command": "npx",
          "args": ["-y", "@cuescout/mcp"]
        }
      }
    }
  3. Refresh the server list

    Cascade has a refresh control in the MCP panel, which is faster than restarting. The five tools appear under the server once it connects.

What this does not do

  • Public pages only, read over HTTP.
  • The answers reflect your deployed site, not your editor buffer.
  • Nothing is stored between calls.

Questions

Does Windsurf need a restart?

Usually not — the MCP panel has a refresh that re-reads the config. A restart is the fallback when a server refuses to appear.

Does this need a CueScout account?

No. The five tools call public endpoints with no authentication — the same ones behind the free tool pages. There is no key to paste and nothing to sign up for.

What does it cost?

Nothing to you. Four of the five tools are HTTP fetches against the site you name. The visibility check puts a real question to a search-grounded engine, which costs us a model call, so it is rate-limited per IP.

Is any of this stored?

Each run keeps a short record: what you entered, a summary of the result, the time and your IP address, so the daily limits can be enforced. The privacy policy has the details. Nothing is added to a CueScout account. If you want the same checks tracked over time against a site you own, that is the paid product.

Run the checks on your own site

The readiness check is free, needs no signup and takes about half a minute. It works out what your site is built on and gives you the fixes written for it.