All agents
EditorsWindsurf

Whole-repo work, with the traffic behind each file attached

Cascade can pull the traffic behind the file it is looking at. One MCP server, five read-only tools, and a key that opens exactly one site.

  • TransportStreamable HTTP
  • AccessRead only, always
  • ScopeOne site per key
Whole-repo work, where the question is which of these pages matters.
Why Windsurf
How to connect

Three steps, and Windsurf can read your site

A key is issued per site and cannot be talked into reading another one, so handing one to an agent hands it exactly what you meant.

  1. Issue a site key

    In Alexander: Settings, Integrations, MCP server. Keys look like alx_ and a fresh one is shown once, so paste it straight into the config below.

    alx_live_7f2c…

  2. In the Windsurf MCP config, add the server

    Paste this into ~/.codeium/windsurf/mcp_config.json.

    ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "alexander": {
          "type": "http",
          "url": "https://mcp.alxndr.ai/mcp",
          "headers": {
            "Authorization": "Bearer alx_your_site_key"
          }
        }
      }
    }
  3. Ask it something you already know

    The fastest way to tell a working connection from a confident guess is to ask for a number you can check.

    ask Windsurf
    Cascade, which routes in this app nobody visits?
What you can ask

Questions, not queries

Type it the way you would say it. Windsurf picks the tool, Alexander returns the rows, and the answer arrives with the numbers in it.

Cascade, which routes in this app nobody visits?

get_pages· Pages

Eleven routes under 40 views a month, including /features/compare and four legacy blog posts.

Where should the signup CTA go?

get_funnel· Funnel

4,110 people reach pricing and 1,003 start a signup. /docs sends 1,402 reads and almost nothing.

What changed this week that I did not cause?

get_sources· Sources

ChatGPT referrals up 22% to 1,118 visitors, converting at 5.1%. No deploy touched that path.

Example answers, shaped exactly as the tools return them, on a demo shop rather than a real customer's books.

The surface

Five tools. That is the whole of it.

Every client on this site reaches the same five, and not one of them can write. There is no sixth tool, no settings tool and no way to reach a site the key was not issued for.

Headline numbers

get_overview

Visitors, pageviews, revenue, conversions, bounce rate and who is on the site this second.

Sources

get_sources

Where visitors came from, ranked by revenue per visitor rather than by volume.

Pages

get_pages

The most viewed pages, each with the revenue of the sessions that saw it.

Funnel

get_funnel

Every step with the drop-off to the next, so the leak has a name.

Insights

get_insights

The written findings: what changed, the evidence, the suggested action, a confidence score.

Also works with

Point Windsurf at your own numbers

Add the tracker, issue a key for the site, paste it where the config goes. The free plan covers 10,000 events a month and asks for no card.

10,000 events a month on the free plan, no card, and the tracker is one line.