Axiom Refract + Windsurf
Enhance Windsurf's AI capabilities with real-time architectural intelligence from Axiom Refract
How It Works
Access MCP Configuration
In Windsurf, navigate to the MCP server configuration in your settings or edit the MCP configuration file directly.
Add Axiom Endpoint
Add the Axiom Refract MCP server with the Streamable HTTP endpoint URL. No authentication token is required during the beta period.
Reload the Editor
Reload Windsurf to establish the MCP connection. The Axiom tools will be discovered automatically during the MCP handshake.
Start Querying
Use Windsurf's AI features to ask about codebase architecture. The AI will use Axiom's 16 tools to provide structurally verified answers.
What You Can Do
Architecture-Aware Completions
Windsurf's AI can consider architectural context when suggesting code changes — understanding which files are critical and which are safe to modify aggressively.
Structural Code Review
When reviewing code, Windsurf can query SPOF status and centrality metrics for modified files, highlighting changes that warrant extra attention.
Zone Navigation
Windsurf can query architectural zones to help you navigate unfamiliar parts of the codebase with structural context about module boundaries and responsibilities.
Impact Preview
Before committing changes, Windsurf can compute the blast radius to preview the potential impact on the rest of the codebase.
Setup
Open Windsurf's settings and locate the MCP server configuration section. Add a new MCP server with the Axiom Refract endpoint. Save and reload the editor. The 16 architectural governance tools will be available to Windsurf's AI features immediately.
{
"mcpServers": {
"axiom-refract": {
"type": "http",
"url": "https://axiomrefract.com/mcp"
}
}
}Why This Matters
Windsurf combines AI assistance with a full-featured IDE experience. Adding Axiom Refract's MCP server gives Windsurf's AI access to the complete architectural record of your codebase, enabling structurally informed assistance that goes beyond what code context alone can provide.