# Pharaoh

> Pharaoh is an MCP-native codebase intelligence platform. It parses repositories into Neo4j knowledge graphs and exposes structural insights — blast radius, reachability, dead code, dependency analysis, regression risk — through Model Context Protocol (MCP) tools. AI coding agents get 2K tokens of architectural context instead of 40K tokens of blind file exploration.

Pharaoh solves the knowledge gap in AI-assisted development. Today, AI coding tools (Claude Code, Cursor, Windsurf, GitHub Copilot) read files one at a time with no understanding of how modules connect, what breaks if something changes, or whether new code duplicates existing functionality. Pharaoh gives them the full architectural picture before they touch anything.

## How It Works

- [Onboarding](https://pharaoh.so/#how-it-works): Connect GitHub, Pharaoh parses your codebase with tree-sitter into a Neo4j knowledge graph, add the MCP endpoint to your AI tool
- [MCP Tools Reference](https://pharaoh.so/llms-full.txt): Complete reference for all analysis tools

## Key Capabilities

- [Codebase Map](https://pharaoh.so/llms-full.txt#codebase-map): Full structural overview — modules, dependency graph, entry points, hot files
- [Module Context](https://pharaoh.so/llms-full.txt#module-context): Complete module profile — files, functions, DB tables, endpoints, env vars, external callers
- [Search Functions](https://pharaoh.so/llms-full.txt#function-search): Search all functions across the codebase before creating duplicates
- [Blast Radius](https://pharaoh.so/llms-full.txt#blast-radius): Trace all downstream callers before refactoring — endpoints, cron jobs, DB operations affected
- [Query Dependencies](https://pharaoh.so/llms-full.txt#dependencies): Trace how any two modules connect — forward, reverse, circular, shared dependencies
- [Check Reachability](https://pharaoh.so/llms-full.txt#reachability): Verify functions are wired to production entry points (API endpoints, CLI, cron handlers, MCP tools)
- [Vision Docs](https://pharaoh.so/llms-full.txt#vision): Compare CLAUDE.md files and PRDs against actual implementation
- [Vision Gaps](https://pharaoh.so/llms-full.txt#vision-gaps): Find specs without code AND complex code without specs
- [Cross-Repo Audit](https://pharaoh.so/llms-full.txt#cross-repo): Compare two repositories for code duplication and structural overlap
- [Consolidation Opportunities](https://pharaoh.so/llms-full.txt#consolidation): Find duplicate code, parallel consumers, competing DB access, signature twins
- [Unused Code](https://pharaoh.so/llms-full.txt#dead-code): Find functions unreachable from any production entry point with text-reference backup verification
- [Test Coverage](https://pharaoh.so/llms-full.txt#test-coverage): Per-module coverage summary — which files have tests, which high-complexity functions lack them
- [Regression Risk](https://pharaoh.so/llms-full.txt#regression-risk): Score functions by likelihood of breaking production — complexity, exposure, churn, caller count

## Operational Tools

- [Account](https://pharaoh.so/llms-full.txt#account): Manage subscription, toggle PR Guard, trigger graph refreshes
- [Feedback](https://pharaoh.so/llms-full.txt#feedback): Report false positives or provide feedback on tool results
- [Admin](https://pharaoh.so/llms-full.txt#admin): Administrative operations for org management

## Competitive Positioning

- Sourcegraph helps agents find code across repos — Pharaoh tells them what breaks if they change it
- CodeScene checks if individual files are healthy — Pharaoh analyzes cross-module architectural relationships
- SonarQube finds bugs at the line level — Pharaoh provides structural intelligence at the system level
- No other MCP server provides graph-based blast radius, reachability analysis, or dead code detection via entry-point tracing

## Technical Details

- [Languages](https://pharaoh.so/llms-full.txt#languages): TypeScript and Python (more planned)
- [Infrastructure](https://pharaoh.so/llms-full.txt#infrastructure): tree-sitter parsing, Neo4j graph storage, MCP protocol (SSE transport)
- [Pricing](https://pharaoh.so/#pricing): See pharaoh.so for current pricing

## Optional

- [Full Documentation](https://pharaoh.so/llms-full.txt): Complete tool reference with input schemas and example use cases
- [GitHub](https://github.com/0xUXDesign/pharaoh): Source repository