agentmako — Claude Code MCP server: codebase intelligence
A local engine that hands your agent a small tool surface for reading a project before touching it. Useful when you open an unfamiliar repo.
claude mcp add agentmako -- npx -y agentmakoWhat agentmako does
agentmako indexes your repository and keeps the facts in a local SQLite store. The agent asks questions through reef_ask, and the server answers with pointers to files, routes, symbols and earlier findings. That replaces long tool chains and raw grep sweeps with one query.
The Reef engine gathers facts from the indexed state, the working tree and staged files. It also extracts project conventions: auth guards, runtime boundaries, generated paths, route patterns. Diagnostics come in from TypeScript, ESLint, Oxlint, Biome and staged git. Rule packs live in .mako/rules as YAML and reload on change. There is a local dashboard, plus optional Postgres/Supabase schema inspection.
Node.js 20 or newer is required. The first run is meant to go with --no-db, so code intelligence works before you add database scope. Database access is wired later through DATABASE_URL. Everything runs on your machine; no hosted service is involved.
What it helps with
- figure out which files and routes matter in an unfamiliar repo
- locate symbols and tables tied to a specific task
- check diagnostic freshness before calling work done
- see the blast radius of a changed file
- keep review notes on tables and RLS
Example prompts for the agent
- Ask Mako where to inspect auth route state
- Run
reef_statusand show which files changed and what diagnostics went stale - Run
reef_impacton the changed file and show me the blast radius
How to install agentmako
Platform CLI
claude mcp add agentmako -- npx -y agentmakoPlatform CLI
codex mcp add agentmako -- npx -y agentmakoConfig file
{
"mcpServers": {
"agentmako": {
"command": "npx",
"args": [
"-y",
"agentmako"
]
}
}
}Config file
{
"servers": {
"agentmako": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agentmako"
]
}
}
}Platform CLI
gemini mcp add agentmako npx -y agentmakoStep 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 agentmako
How do I install agentmako in Claude Code?
Run claude mcp add agentmako -- npx -y agentmako, then restart the client and confirm the server starts.
What does agentmako do?
It indexes your project and answers agent questions with facts from code, database and diagnostics. The main entry point is reef_ask.
Do I need a database for it to work?
No, Mako runs without one. Postgres or Supabase awareness is added separately, after code intelligence is working.
