MCP Integration (AI Assistants)

Ranex can be used from MCP-compatible AI assistants via a local MCP server binary:

• ranex-mcp-server

This runs locally and communicates over stdio.

Environment variables

• RANEX_PROJECT_ROOT
  • Absolute path to the project you want the MCP server to analyze.
• RANEX_LOG
  • Log level: trace, debug, info, warn, error.

Minimal MCP client configuration

Configure your MCP client to run ranex-mcp-server and set RANEX_PROJECT_ROOT.

Key points:

• ranex-mcp-server must be on your PATH or referenced by absolute path.
• Logs are written to stderr.

Tools exposed over MCP

Atlas tools

The server exposes Atlas tools for scanning, search, dependency/impact analysis, and FastAPI analysis.

Common tool names include:

• ranex_atlas_scan
• ranex_atlas_search (span-first search; returns file paths with line ranges)
• ranex_atlas_search_by_feature
• ranex_atlas_get_symbol
• ranex_atlas_count
• ranex_atlas_health
• ranex_atlas_get_dependents
• ranex_atlas_get_dependencies
• ranex_atlas_analyze_function_impact
• ranex_atlas_analyze_file_impact
• ranex_atlas_detect_patterns
• ranex_atlas_get_patterns
• ranex_atlas_find_duplicates
• ranex_atlas_detect_cycles
• ranex_atlas_glob
• ranex_atlas_grep
• ranex_atlas_read_span
• ranex_atlas_fastapi_scaling_policy
• ranex_atlas_fastapi_scaling_report
• ranex_atlas_fastapi_router_topology
• ranex_atlas_fastapi_truth_capsule

Firewall tools

• ranex_firewall_check_import
• ranex_firewall_check_imports
• ranex_firewall_analyze_file
• ranex_firewall_check_typosquat
• ranex_firewall_get_policy_info
• ranex_firewall_get_allowed_packages
• ranex_firewall_get_blocked_patterns
• ranex_firewall_policy_mode
• ranex_firewall_list_rules

Help tools

• ranex_help_atlas_overview
• ranex_help_firewall_overview

Recommended MCP workflow

1. Set RANEX_PROJECT_ROOT to the project you care about.
2. Run ranex_atlas_scan once.
3. Use ranex_atlas_search / ranex_atlas_search_spans to locate relevant code.
4. Use impact tools before proposing edits.
5. Use firewall tools before introducing new dependencies.