# Pharaoh - Your AI breaks things it can't see

Pharaoh maps your entire architecture into a knowledge graph your AI queries before writing a single line.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add pharaoh/pharaoh-so

# Browse available tools
npx -y @smithery/cli@latest tool list pharaoh/pharaoh-so

# Get full schema for a tool
npx -y @smithery/cli@latest tool get pharaoh/pharaoh-so get_codebase_map

# Call a tool
npx -y @smithery/cli@latest tool call pharaoh/pharaoh-so get_codebase_map '{}'
```

## Direct MCP Connection

Endpoint: `https://pharaoh.run.tools`

**Optional config:**
- `server` (query) — Pharaoh server URL

## Tools (22)

- `get_codebase_map` — Pharaoh is a codebase knowledge graph. Call this FIRST — get the full architecture instead of reading files one-by-one.
- `pharaoh_recon` — Get the full architectural picture in ONE call — combines codebase map, module deep-dives, function search, blast radiu…
- `get_module_context` — Get everything you need to know about a module BEFORE modifying it or writing a PRD.
- `get_blast_radius` — Check what breaks BEFORE refactoring, renaming, or deleting a function, file, or module.
- `check_reachability` — Check if functions are reachable from production entry points (API endpoints, CLI commands, cron jobs, event handlers, …
- `get_vision_docs` — Get the documented intent — CLAUDE.md files, PRDs, roadmaps, skill specs — to understand WHY code exists, not just what…
- `get_vision_gaps` — Find what's missing — specs without code AND complex code without specs. Call this to prioritize what to build or docum…
- `query_dependencies` — Trace how two modules are connected BEFORE splitting, merging, or decoupling them.
- `search_functions` — Check if functionality already exists BEFORE writing any new function, utility, or helper.
- `get_cross_repo_audit` — Compare two repositories for code duplication, structural overlap, and shared patterns.
- `get_consolidation_opportunities` — Find code that does the same work in different places — parallel consumers, duplicated call chains, competing DB access…
- `get_unused_code` — Find dead code — functions not reachable from any production entry point.
- `get_test_coverage` — See which modules and files have test coverage and which don't.
- `get_regression_risk` — Score functions by regression risk — how likely a change here breaks production.
- `get_design_system` — Discover the design system BEFORE creating any UI component.
- `setup_environment` — Set up the optimal Claude Code environment for this codebase — install Pharaoh's curated plugin bundle.
- `get_pharaoh_docs` — Stuck, confused, or troubleshooting? Get help from Pharaoh's documentation. Ask about setup, tools, security, pricing, …
- `pharaoh_account` — View your Pharaoh subscription status and manage billing. Toggle PR Guard and trigger graph refreshes.
- `pharaoh_feedback` — Call this when results were unexpectedly empty or unhelpful, or when a tool gave you exactly what you needed.
- `request_upload` — Map a local repo into Pharaoh without installing the GitHub App. Source code never leaves the machine — only structural…
- `map_open_source_repo` — Map a public GitHub repository into Pharaoh so you can query its architecture. The repo will be available to all Pharao…
- `pharaoh_admin` — Superadmin controls for Pharaoh infrastructure. Only available to admin tenants.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get pharaoh/pharaoh-so <tool-name>
```

## Resources

- `ui://pharaoh/codebase-explorer` — Interactive codebase architecture visualization

## Prompts (10)

- `safe-refactor` (repo, target) — Step-by-step workflow to safely refactor a function or module with full blast radius awareness.
- `pre-pr-review` (repo, modules) — Architectural review checklist to run before opening a pull request.
- `onboard-to-codebase` (repo) — Quick orientation to a new codebase — understand modules, key functions, and architecture using only free-tier tools.
- `investigate-change` (repo, target) — Gather full architectural context before modifying a function, file, or module — free-tier tools only.
- `explore-module` (repo, module) — Deep-dive into a single module — understand its purpose, key functions, dependencies, and risk areas using free-tier to…
- `health-check` (repo) — Full codebase health sweep — grade (A-F), top risks, tech debt hotspots, spec drift, and prioritized actions. Requires …
- `find-tech-debt` (repo) — Categorized tech debt report — dead code, duplicates, undocumented complexity, volatile modules, untested functions. Re…
- `validate-wiring` (repo, module) — Verify that code in a module is properly connected — reachable from entry points, has callers, and is tested. Requires …
- `plan-with-pharaoh` (repo, description) — Architecture-aware planning — 4-phase workflow combining reconnaissance, analysis, approach selection, and step-by-step…
- `review-with-pharaoh` (repo, modules) — Architecture-aware pre-PR review — 4-phase workflow with context gathering, risk assessment, spec alignment, and auto-b…