Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http pharaoh https://mcp.pharaoh.so/mcp
Open on GitHub

What 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/mcp

2Platform CLI

claude mcp add pharaoh -- npx -y @pharaoh-so/mcp

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open