Axiom Refract + Claude Code

Give Claude Code direct access to your architectural record via native MCP integration

How It Works

1

Add MCP Configuration

Add the Axiom Refract MCP server configuration to your Claude Code settings file (.mcp.json in your project root or ~/.claude/.mcp.json for global access).

2

Reload Claude Code

Restart or reload your Claude Code session to pick up the new MCP server configuration. The MCP connection initializes automatically.

3

Verify Connection

Claude Code will discover 16 architectural governance tools from the Axiom MCP server. You can verify by asking Claude about available tools or requesting an architectural overview.

4

Query Architecture

Ask Claude Code questions about your codebase architecture. Claude will use Axiom's MCP tools to answer with verified structural data — blast radius, SPOF analysis, centrality metrics, and more.

What You Can Do

Blast Radius Before Changes

Before modifying a file, Claude can query its blast radius — knowing exactly what would break and how many files are affected. This enables structurally informed code changes.

SPOF-Aware Code Review

Claude can check whether files being modified are single points of failure, adjusting its review thoroughness based on structural criticality.

Architecture-Guided Refactoring

Claude can query the migration plan, dead code inventory, and coupling analysis to suggest refactoring actions backed by structural data.

Zone-Aware Task Routing

Claude can identify which architectural zone a task belongs to, ensuring changes are scoped to the correct part of the codebase.

Setup

Create or edit .mcp.json in your project root directory. Add the Axiom Refract MCP server configuration with the Streamable HTTP endpoint. Save the file and reload your Claude Code session. Claude will automatically discover and connect to the 16 architectural governance tools. No API key is required during the beta period.

{
  "mcpServers": {
    "axiom-refract": {
      "type": "http",
      "url": "https://axiomrefract.com/mcp"
    }
  }
}

Why This Matters

Claude Code is one of the most capable AI coding agents available. By connecting it to Axiom Refract via MCP, you give Claude access to verified architectural data — dependency graphs, centrality scores, SPOF flags, and blast radius calculations. Instead of inferring structure from the code it can see in context, Claude can query the complete architectural record and make structurally informed decisions.

Read the Docs →