Agentmako

Name: Agentmako
Author: drhalto

by drhaltocommunityv0.2.3

agentmako is a local-first MCP server and CLI that indexes a codebase, builds local SQLite-backed facts, and returns structured project context for coding agents. It also supports optional database schema awareness, review notes, and a local dashboard, all without requiring a hosted service.

From the registry: Local-first codebase intelligence MCP server for AI coding agents.

GitHub Repository

Install & configure

Prerequisites

required
Install Node.js 20 or newer
Agentmako requires Node.js 20+.
https://nodejs.org/
required
Install agentmako CLI
Install the published agentmako package globally so the `agentmako` command is available on your PATH.
```
$ npm install -g agentmako
```
https://www.npmjs.com/package/agentmako
required
Attach and index your project
From the project you want Agentmako to understand, connect the repository before using the MCP server. The README recommends `--no-db` for the first run.
```
$ agentmako connect . --no-db
```
optional
Optional database setup
If you want Postgres/Supabase awareness, run interactive connect or provide a database URL via an environment variable during setup. This is not required for basic MCP usage.
```
$ agentmako connect .
```

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `agentmako` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install Node.js 20 or newer** — Agentmako requires Node.js 20+. (https://nodejs.org/)
- **Install agentmako CLI** — Install the published agentmako package globally so the `agentmako` command is available on your PATH. Run: `npm install -g agentmako` (https://www.npmjs.com/package/agentmako)
- **Attach and index your project** — From the project you want Agentmako to understand, connect the repository before using the MCP server. The README recommends `--no-db` for the first run. Run: `agentmako connect . --no-db`

Optional prerequisites:
- Optional database setup — If you want Postgres/Supabase awareness, run interactive connect or provide a database URL via an environment variable during setup. This is not required for basic MCP usage. Run: `agentmako connect .`

Canonical MCP server config (stdio transport):
- command: `agentmako`
- args: ["mcp"]

Note: The README's MCP configuration uses the stdio server entry `agentmako mcp`. No MCP-specific environment variables are required for the default setup. Database-related configuration is handled during `agentmako connect` setup rather than via the MCP client config.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: The README's MCP configuration uses the stdio server entry `agentmako mcp`. No MCP-specific environment variables are required for the default setup. Database-related configuration is handled during `agentmako connect` setup rather than via the MCP client config.

Tools (14)

mako_help

Provides workflow orientation for using Mako.

context_packet

Returns a deterministic packet of structured context for a coding task.

reef_scout

Ranks relevant project facts, findings, and history for a query.

cross_search

Performs code search across the repository.

live_text_search

Searches repository text in live state.

ast_find_pattern

Finds patterns in the code AST.

repo_map

Maps repository structure and key files.

project_conventions

Returns discovered project conventions such as auth, runtime, routes, and schema usage.

file_preflight

Gathers findings, diagnostic freshness, conventions, recent runs, and acknowledgement history for one file before editing.

reef_diff_impact

Summarizes changed-file callers, caller findings, and convention risks during or before review.

extract_rule_template

Creates a reviewable .mako/rules YAML draft from a fixed bug pattern.

ask

Answers natural-language repository questions.

tool_search

Environment variables

DATABASE_URLrequiredUsed for scripted or CI setup to connect Mako to a Postgres/Supabase database.

Prerequisites

• Node.js >=20
• Node.js 20
• Node.js 20+

Packages

agentmako

npmv0.2.3transport: stdio

Details

Language: TypeScript
License: Apache-2.0
Released: Apr 29, 2026
Last commit: May 24, 2026
Registry name: io.github.drhalto/agentmako

Related Servers

Netdata

Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.

79.4k

Labelhead Artist Momentum

Trending hip-hop artist momentum scores across four cultural dimensions.

71.4k

Scrapling

Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.

65.8k