Claude Code

Connect Pharaoh to Claude Code so it sees your codebase architecture in every conversation.

Prerequisite: Install the GitHub App first.

Setup

Run one command:

npx @pharaoh-so/mcp

This handles everything: authenticates via GitHub, registers Pharaoh as a global MCP server, and installs all development skills. Safe to re-run — it resets and reinstalls fresh.

Alternative: Direct SSE (no local process)

If you prefer a direct SSE connection instead of the stdio proxy:

claude mcp add --transport sse --scope user pharaoh https://mcp.pharaoh.so/sse

Verify

Start a new conversation and ask:

What modules does this codebase have?

Claude should call get_codebase_map and return a module breakdown with file counts, function counts, and dependency relationships.

What happens automatically

• Claude calls Pharaoh tools before making architectural decisions - checking for duplicate functions, understanding callers, mapping module boundaries
• Every push to your default branch refreshes the graph within minutes
• No config files or per-repo setup needed after the initial install
• Pharaoh tools return structured data in minimal tokens so Claude has room to reason

Troubleshooting

"No repos found" or empty results: The GitHub App must be installed on the correct org or account. Go to github.com/apps/pharaoh-so/installations/new and verify the installation covers the repos you expect.

OAuth fails or redirects to an error: Authorize with the same GitHub account that has the Pharaoh app installed. If you have multiple GitHub accounts, check which one is signed in.

Connection drops or tools stop responding: Re-run setup (it removes stale entries automatically):

npx @pharaoh-so/mcp

Tools not appearing in conversation: Start a new conversation after adding the MCP server. Existing conversations don't pick up new servers.