Axiom Refract + MCP Protocol (Generic)
Connect any MCP-compatible AI agent or tool to Axiom Refract's 16 architectural governance tools
How It Works
Initialize MCP Session
Send a POST request to the Axiom MCP endpoint with an initialize message. The server responds with its capabilities and issues a session ID via the mcp-session-id header.
Send Initialized Notification
Send a notifications/initialized message with the session ID header to complete the handshake.
Discover Tools
Send a tools/list request to discover all 16 available architectural governance tools with their names, descriptions, and parameter schemas.
Invoke Tools
Call any tool by sending a tools/call request with the tool name and typed arguments. The server returns structured architectural data.
What You Can Do
Universal AI Agent Compatibility
Any client that implements the MCP specification can connect to Axiom — including future AI tools, custom agents, and internal platform tools.
16 Purpose-Built Tools
Access system overview, danger zones, file details, blast radius, graph nodes, graph edges, zone lookup, task routing, migration plans, dead code, ghost methods, SPOF details, DB tables, supply chain, scenarios, and evidence.
Streamable HTTP Transport
The current recommended MCP transport — standard HTTPS POST requests with session management via the mcp-session-id header. CORS enabled for browser clients.
Stateless Per-Request
Each tool call is independent. The session maintains context about which analysis dataset to query, but individual tool calls do not depend on previous calls.
Setup
For MCP-compatible AI tools (Claude Code, Cursor, Windsurf), add the configuration JSON above to your project's .mcp.json file. For custom clients, implement the MCP Streamable HTTP handshake: POST to https://axiomrefract.com/mcp with initialize, then notifications/initialized, then tools/list, then tools/call. Include the mcp-session-id header from the initialize response in all subsequent requests. Include Accept: application/json, text/event-stream in all request headers.
{
"mcpServers": {
"axiom-refract": {
"type": "http",
"url": "https://axiomrefract.com/mcp"
}
}
}Why This Matters
MCP is the emerging standard for connecting AI agents to external data sources. By implementing a native MCP server, Axiom Refract ensures that any current or future AI tool that speaks MCP can access architectural governance data. This is not a plugin for one specific tool — it is a protocol-level integration that works with the entire MCP ecosystem.