Skip to content

Windsurf

Windsurf’s Cascade agent supports MCP via the mcp_config.json file in your project root (or global via ~/.codeium/windsurf/mcp_config.json).

Per-project

Terminal window
npx @axint/compiler init my-intents
cd my-intents
windsurf .

Then add the Axint server:

~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"axint": {
"command": "npx",
"args": ["-y", "@axint/compiler", "mcp"]
}
}
}

Open Cascade (⌘ L), look for the tool chip near the input — Axint should be listed. The first tool call triggers a permission prompt.

Using Axint with Cascade

Cascade is at its best with structured, multi-step tasks. Try:

Read every intent file in intents/, run axint_validate on each, and write a JSON report to validation-report.json. If any intent has errors, fix them and validate again.

Cascade will batch the validation calls, summarize the diagnostics, and loop on the fixes without needing you to babysit it.