Pharaoh — Claude Code MCP server: what it does, how to install
Pharaoh — an MCP server for Claude Code connects agents to an architectural knowledge graph. The server maps dependencies and computes change impact before modifying files.
MIT ★ 2 updated 2026-11-14
claude mcp add --transport http pharaoh https://mcp.pharaoh.so/mcpWhat Pharaoh does
The proxy links an agent to a structural graph of your project via stdio and SSE. Instead of scanning files individually, the assistant queries module boundaries, finds duplicate logic with search_functions, and assesses ripple effects using get_blast_radius. A single pharaoh_recon call returns map data, context, and impact scope at once.
Operation requires Node.js 18 or newer and an active account on pharaoh.so. Pharaoh indexes code directly through its GitHub App, so the local proxy never transmits source file contents. Credentials persist in ~/.pharaoh/credentials.json with 0600 permissions and expire after 7 days.
What it helps with
- calculate breaking impact of editing a function with get_blast_radius
- locate existing implementations before writing duplicate code
- inspect module relationship maps via get_codebase_map
- gather full structural context prior to refactoring
Example prompts for the agent
- Run pharaoh_recon to see what breaks if we modify authenticateUser
- Check search_functions for existing JWT validation helpers
- Map the payment module dependencies before refactoring
How to install Pharaoh
1Platform CLI: remote server
claude mcp add --transport http pharaoh https://mcp.pharaoh.so/mcp2Platform CLI
claude mcp add pharaoh -- npx -y @pharaoh-so/mcp1Platform CLI: remote server
codex mcp add pharaoh --url https://mcp.pharaoh.so/mcp2Platform CLI
codex mcp add pharaoh -- npx -y @pharaoh-so/mcpConfig file
{
"mcpServers": {
"pharaoh": {
"url": "https://mcp.pharaoh.so/mcp"
}
}
}{
"mcpServers": {
"pharaoh": {
"command": "npx",
"args": [
"-y",
"@pharaoh-so/mcp"
]
}
}
}Config file
{
"servers": {
"pharaoh": {
"type": "http",
"url": "https://mcp.pharaoh.so/mcp"
}
}
}{
"servers": {
"pharaoh": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pharaoh-so/mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http pharaoh https://mcp.pharaoh.so/mcp2Platform CLI
gemini mcp add pharaoh npx -y @pharaoh-so/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Pharaoh
How to install Pharaoh in Claude Code?
To connect via HTTP, run claude mcp add --transport http pharaoh https://mcp.pharaoh.so/mcp. For local stdio execution via npx, use claude mcp add pharaoh -- npx -y @pharaoh-so/mcp.
What does Pharaoh do?
It provides agents with a queryable graph of modules, dependencies, and functions. Agents can inspect architecture maps and check blast radius without opening each file individually.
What is required to run Pharaoh?
You need Node.js 18 or newer and an account at pharaoh.so. Initial device authentication runs interactively with npx @pharaoh-so/mcp.