# Pharaoh

> Pharaoh is an MCP server for developer tools. Give coding agents a queryable map of your codebase: callers, modules and blast radius. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** CLI, API
- **Website:** https://pharaoh.so
- **Repository:** https://github.com/pharaoh-so/pharaoh-mcp
- **MCP Registry name:** so.pharaoh/pharaoh
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Pharaoh builds a persistent graph of functions, callers and dependencies for a connected repository, then refreshes it when the default branch is pushed. The pitch is to replace repeated grep-and-read loops with one lookup. The vendor's own benchmark, run on its TypeScript repo with three runs per question, reports blast-radius questions dropping from 37.3 to 11.0 seconds and a tracing task from 15 file-tool calls to one query. These are the vendor's figures for structural questions, not all work.

This npm package is a stdio proxy so it works where OAuth in a browser is impossible, such as SSH sessions, containers and CI. Running it starts a device-code flow: you open a URL on any device and enter the code. Credentials are stored in ~/.pharaoh/credentials.json for seven days. Relaying goes to the remote server at mcp.pharaoh.so.

A remote Streamable HTTP endpoint is also published. Pricing details are not published beyond a free Pro trial with no credit card.

## Features

- **Codebase map:** Modules and their relationships in one call.
- **Blast radius:** See what breaks before changing a function, file or module.
- **Function search:** Find existing functions, with file and signature.
- **Headless login:** Device-code authorisation for servers, containers and CI.
- **Automatic refresh:** The map updates when the default branch is pushed.

## Good for

- Check affected callers before a refactor
- Avoid writing a function that already exists
- Start parallel subagents with the same codebase map
- Trace which routes and jobs reach a failing function

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http pharaoh https://mcp.pharaoh.so/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.pharaoh.so/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pharaoh": {
      "url": "https://mcp.pharaoh.so/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pharaoh": {
      "type": "http",
      "url": "https://mcp.pharaoh.so/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pharaoh": {
      "serverUrl": "https://mcp.pharaoh.so/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pharaoh": {
      "type": "http",
      "url": "https://mcp.pharaoh.so/mcp"
    }
  }
}
```

## Tools

- `get_codebase_map`: Modules and how they relate
- `get_module_context`: Module context before modifying it
- `search_functions`: Check whether a function already exists
- `pharaoh_recon`: Map, module context, search and blast radius in one call
- `get_blast_radius`: What breaks if a function, file or module changes
- `pharaoh_account`: Check plan, toggle PR Guard, trigger refresh
- `pharaoh_admin`: Org-level administration

## FAQ

### Why a proxy?

It lets Claude Code use Pharaoh on machines without a browser by bridging stdio to the remote server.

### How long do credentials last?

Seven days, with automatic re-authorisation afterwards.

### Which agents work?

Claude Code, Cursor, Codex and OpenClaw are named.

### Is there a free trial?

The site offers a free Pro trial with no credit card.

### Is Pharaoh free?

Pharaoh is a paid product with a free trial.

### How do I add Pharaoh to Claude Code?

Run this command in your terminal: claude mcp add --transport http pharaoh https://mcp.pharaoh.so/mcp

### What are the best alternatives to Pharaoh?

The closest alternatives to Pharaoh are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pharaoh
