Skip to content

Tools

MCP Tools

The Arxo MCP server exposes the following tools. AI assistants call these with a project_path (and optional parameters) to run analysis on the workspace or a given directory.

Tool Status Legend

✅ Working — Fully functional in the MCP server
⚠️ Stub — Placeholder implementation that directs to CLI

Available Tools

Tool	Status	Description
`analyze_architecture`	✅ Working	Full architecture analysis with all metrics or focused presets
`check_cycles`	✅ Working	Fast cycle detection (SCC) for pre-commit checks
`analyze_file_impact`	✅ Working	Analyze blast radius of changing specific files
`check_llm_integration`	✅ Working	LLM integration health check (observability, PII, cost tracking)
`evaluate_policy`	✅ Working	Evaluate architectural policy invariants and get violations
`get_hotspots`	✅ Working	Find architectural hotspots requiring refactoring attention
`list_presets`	✅ Working	List all available analysis presets with descriptions
`analyze_with_baseline`	⚠️ Stub	Compare to baseline git ref (requires full arxo binary)
`suggest_refactors`	⚠️ Stub	Get refactoring recommendations (requires full arxo binary)

Quick Reference

Fast Checks

check_cycles — 1-5 seconds, no caching
list_presets — Instant, no analysis required

Focused Analysis

analyze_file_impact — Impact of specific file changes
check_llm_integration — AI/LLM integration audit
evaluate_policy — Policy compliance check
get_hotspots — Find modules needing refactoring

Comprehensive Analysis

analyze_architecture — Full analysis with presets (cached)

Tool Selection Guide

Use Case	Recommended Tool
Pre-commit check	`check_cycles`
CI/CD gate	`evaluate_policy`
Before refactoring	`analyze_file_impact`
LLM integration audit	`check_llm_integration`
Find problem areas	`get_hotspots`
Explore presets	`list_presets`
Full architecture review	`analyze_architecture` with `full` preset

See Workflows for detailed examples of chaining tools together.