> For the complete documentation index, see [llms.txt](https://pharaoh.so/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pharaoh.so/docs/use-pharaoh/overview.md).

# Tool reference

Pharaoh exposes MCP tools that your AI agent calls automatically. They fall into four categories: **Orient** (understand the codebase), **Investigate** (trace impact), **Audit** (find dead code), and **Manage** (account and administration).

## All Tools

| Tool                 | Category    | Tier | Description                                                                                                 |
| -------------------- | ----------- | ---- | ----------------------------------------------------------------------------------------------------------- |
| `pharaoh_recon`      | Orient      | Free | Batched reconnaissance — codebase map + module context + function search + blast radius in one call         |
| `get_codebase_map`   | Orient      | Free | Full structural overview — modules, dependency graph, entry points, hot files                               |
| `get_module_context` | Orient      | Free | Complete module profile — files, functions, DB tables, endpoints, env vars, external callers                |
| `search_functions`   | Orient      | Free | Search all functions across the codebase before creating duplicates                                         |
| `get_blast_radius`   | Investigate | Free | Trace all downstream callers before refactoring — endpoints, cron jobs, DB operations affected              |
| `get_unused_code`    | Audit       | Free | Find functions no entry point reaches (Dead vs Possibly unused), or check that named functions are wired in |
| `pharaoh_account`    | Manage      | Free | See your plan and live repo, switch the live repo, refresh a repo, upgrade                                  |
| `pharaoh_admin`      | Manage      | Free | Internal administration, restricted to authorized Pharaoh operators                                         |

## Use a tool

Ask your AI to call a tool by name in chat. The connected client exposes its current input schema. For detailed inputs, see the [tool reference](https://pharaoh.so/llms-full.txt).

Start with `get_codebase_map`. Use `get_blast_radius` for production callers (one to five hops), and `get_unused_code` to check names or `Class.method`. Results describe the mapped default branch. A missing direct test link is not runtime test coverage.

[Scope and troubleshooting](/docs/use-pharaoh/troubleshooting.md) · [Account and billing](/docs/use-pharaoh/pricing.md)