XRAY: Progressive code intelligence for AI assistants - Map, Find, Impact
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"git-project-xray-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# XRAY MCP - Progressive Code Intelligence for AI Assistants [](https://python.org) [](https://modelcontextprotocol.io) [](https://ast-grep.github.io) ## ❌ Without XRAY AI assistants struggle with codebase understanding. You get: - ❌ "I can't see your code structure" - ❌ "I don't know what depends on this function" - ❌ Generic refactoring advice without impact analysis - ❌ No understanding of symbol relationships ## ✅ With XRAY XRAY gives AI assistants code navigation capabilities. Add `use XRAY tools` to your prompt: ```txt Analyze the UserService class and show me what would break if I change the authenticate method. use XRAY tools ``` ```txt Find all functions that call validate_user and show their dependencies. use XRAY tools ``` XRAY provides three focused tools: - 🗺️ **Map** (`explore_repo`) - See project structure with symbol skeletons - 🔍 **Find** (`find_symbol`) - Locate functions and classes with fuzzy search - 💥 **Impact** (`what_breaks`) - Find where a symbol is referenced ## 🚀 Quick Install ### Install from PyPI (Easiest) ```bash # Install directly from PyPI with pip pip install git-project-xray-mcp # Or with uv (faster) uv pip install git-project-xray-mcp # Then run git-project-xray-mcp ``` ### Install with uv Tool (Recommended for MCP) ```bash # Install uv if you don't have it curl -LsSf https://astral.sh/uv/install.sh | sh # Install as a uv tool uv tool install git-project-xray-mcp # Then run from anywhere git-project-xray-mcp ``` ### Automated Install with uv For the quickest setup, this script automates the `uv` installation process. ```bash curl -fsSL https://raw.githubusercontent.com/Jamie-BitFlight/git-project-xray-mcp/main/install.sh | bash ``` ### Install from Source (Development) ```bash git clone https://github.com/Jamie-BitFlight/…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.