Skip to content

Quick Start

This tutorial walks you through installing axm-mcp and running it as an MCP server.

Prerequisites

  • Python 3.12+
  • uv

Installation

Bash
uv add axm-mcp

To include all AXM tools:

Bash
uv add "axm-mcp[all]"

Step 1: Start the Server

Bash
axm-mcp

The server starts and auto-discovers all installed axm.tools entry points.

Step 2: List Available Tools

From any MCP client, call the list_tools meta-tool:

JSON
{"name": "list_tools"}

This returns all discovered tools with names and descriptions.

Step 3: Run Verify

The verify tool checks any project in one shot:

JSON
{"name": "verify", "arguments": {"path": "/path/to/project"}}

Returns audit score, governance score, and AST-enriched failure context.

Next Steps