axm-mcp
MCP server for the AXM ecosystem — runtime tool discovery and execution.
Features
- 🔌 Auto-discovery — Finds all
axm.toolsentry points from installed packages - 🛠️ MCP bridge — Exposes discovered tools as Model Context Protocol callables
- ✅ Verify — One-shot project quality check: audit + init check + AST enrichment
- 🚀 HTTP transport — Optional persistent Streamable HTTP server (
axm-mcp serve) for a single shared process across conversations
Installation
Connect the server to your MCP client in one command — uvx fetches it on
demand, no manual install:
The [all] extra pulls in the actual tools (audit, ast_*, …); the bare
package is only the server shell. See the Quick Start
for the .mcp.json form and the full walkthrough.
Once connected, all discovered AXM tools are immediately available to your MCP client.
MCP Tools
By default the server exposes a compact facade — axm_search / axm_describe /
axm_call / axm_capabilities — over the full catalog (AXM_MCP_FACADE=1),
plus the built-ins below. Set AXM_MCP_FACADE=0 to register every discovered
tool directly.
| Tool | Package | Description |
|---|---|---|
verify |
built-in | One-shot audit + init check + AST enrichment |
web_fetch |
built-in | Fetch web pages with anti-bot bypass (basic / dynamic / stealth) |
list_tools |
built-in | List all available tools |
audit |
axm-audit |
Code quality audit (lint, types, complexity, security) |
init_check |
axm-init |
49 governance checks against AXM gold standard |
init_scaffold |
axm-init |
Scaffold a new Python project |
bib_search |
axm-bib |
Search academic papers by title |
bib_resolve |
axm-bib |
Resolve a DOI/arXiv ref → BibTeX |
bib_pdf |
axm-bib |
Download paper PDF |
bib_extract |
axm-bib |
Extract text from PDF |