Agentmako MCP server

agentmako

agentmako is a local-first codebase intelligence engine for AI coding tools.

It gives agents like Codex, Claude Code, Cursor, and local harnesses a compact Reef-first tool surface for understanding a project before they edit it. Mako indexes your repo, builds local SQLite-backed facts, tracks diagnostics and review notes, and answers evidence-backed questions instead of making the agent orchestrate broad tool chains or rediscover everything with raw grep.

Mako is built for the first mile of coding-agent work:

What files matter? What routes, symbols, tables, diagnostics, and prior

findings are relevant? What should the agent read next?

What You Get

diagnostics, instructions, freshness, and literal checks

• MCP server for coding agents: agentmako mcp
• Local dashboard: agentmako dashboard
• Primary project query: reef_ask across code, database, findings,

and local-state mutations

• Queryable workflow orientation: mako_help
• Deterministic context expansion: context_packet
• _hints on tool results so agents get result-specific next steps
• Central MCP annotations so clients can distinguish safe reads, live reads,

livetextsearch, lintfiles, and toolbatch

• Compact loop/fallback tools: reefstatus, reefverify, reef_impact,

working-tree, and staged state

• Reef Engine facts and findings across indexed,

paths, route patterns, and schema usage

• Reef convention extraction for auth guards, runtime boundaries, generated

cross-file helper-bypass rules via canonicalHelper

• TypeScript, ESLint, Oxlint, Biome, and staged git diagnostic ingestion
• Hot-reloaded .mako/rules YAML rule packs, including primitive

publications, subscriptions, and replication

• Optional Postgres/Supabase schema snapshots and read-only DB inspection
• Local DB review comments for notes on tables, RLS, triggers,

• Recall, acknowledgements, and agent feedback for repeated review work

Everything important runs locally. No hosted service is required.

Install

Requires Node.js 20 or newer.

npm install -g agentmako

Confirm the CLI is available:

agentmako --version
agentmako doctor

You should see green checks for configuration and the local API service.

Prefer to build from source (e.g. to contribute)? See

Develop From Source at the bottom of this

file.

Happy Path Setup

1. Attach your real project

Go to the project you want Mako to understand:

cd C:/path/to/your/project

Attach and index it:

agentmako connect . --no-db

Use --no-db for the first run. It gets the code intelligence path working before adding database scope.

2. Confirm Mako sees the project

agentmako status .
agentmako tool list

Run a real Reef query:

agentmako --json tool call . reef_ask "{\"question\":\"where should I inspect auth route state?\"}"

If that returns an evidence-backed answer, facts, findings, or next queries, the core setup is working.

Shortened. The full README is on GitHub.