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
# Connect this server (installs CLI if needed)
npx -y smithery mcp add pharaoh/pharaoh-so
# Browse available tools
npx -y smithery tool list pharaoh/pharaoh-so
# Get full schema for a tool
npx -y smithery tool get pharaoh/pharaoh-so get_codebase_map
# Call a tool
npx -y smithery 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.
# Get full input/output schema for a tool
npx -y smithery tool get pharaoh/pharaoh-so 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…