Codebase Intelligence
📇 🏠 🍎 🪟 🐧 - Local-first codebase intelligence engine. Gives coding agents structured context packets, i
What is Codebase Intelligence?
Codebase Intelligence is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 🏠 🍎 🪟 🐧 - local-first codebase intelligence engine. gives coding agents structured context packets, i
📇 🏠 🍎 🪟 🐧 - Local-first codebase intelligence engine. Gives coding agents structured context packets, i
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
NPM
npx -y agentmakoManual Installation
npx -y agentmakoConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Codebase Intelligence
agentmako is a local-first codebase intelligence engine that gives AI coding agents structured context about your projects — enabling faster, more accurate code edits by providing targeted context packets, repo maps, impact assessments, and semantic search rather than forcing the AI to read entire files. It integrates with Claude Code, Cursor, Codex, and any MCP-compatible client, exposing tools like context_packet, reef_scout, file_preflight, ast_find_pattern, and repo_map that help agents understand code architecture before making changes. Developers use it to reduce hallucinations, cut token usage, and accelerate complex refactoring and feature development tasks.
Prerequisites
- Node.js 20 or newer installed
- npm or pnpm package manager
- Claude Code, Cursor, or another MCP-compatible coding assistant
- Optional: a PostgreSQL or Supabase database connection string for schema snapshot features (DATABASE_URL)
Install agentmako globally
Install the agentmako CLI globally via npm so it is available system-wide.
npm install -g agentmakoVerify the installation
Check that agentmako is installed correctly and run the doctor command to verify your environment.
agentmako --version
agentmako doctorConnect agentmako to your project
Run the connect command in your project directory to index the codebase. Use --no-db if you do not have a PostgreSQL database.
cd /path/to/your/project
agentmako connect . --no-dbAdd agentmako to your MCP client config
Add the mako-ai server to your Claude Desktop or Claude Code MCP configuration.
{
"mcpServers": {
"mako-ai": {
"command": "agentmako",
"args": ["mcp"]
}
}
}Optional: configure database schema snapshots
If you want agentmako to include database schema context in its packets, set DATABASE_URL in your environment and reconnect with the --db-env flag.
DATABASE_URL=postgres://user:pass@localhost:5432/mydb agentmako connect . --db-env DATABASE_URL --yesCodebase Intelligence Examples
Client configuration
Claude Desktop configuration block for agentmako MCP server.
{
"mcpServers": {
"mako-ai": {
"command": "agentmako",
"args": ["mcp"]
}
}
}Prompts to try
Example prompts leveraging agentmako's code intelligence tools for development tasks.
- "Get me a context packet for fixing the broken auth callback route"
- "Use reef_scout to find where session state is managed in this codebase"
- "Run file_preflight on src/api/users.ts before I edit it"
- "Show me a repo map so I understand the top-level architecture"
- "Find all places in the code that match the pattern of an unguarded database call"
- "What are the project conventions for authentication and routing?"Troubleshooting Codebase Intelligence
agentmako command not found after npm install -g
The global npm bin directory may not be in your PATH. Run 'npm bin -g' to find it and add it to your PATH. On macOS/Linux: export PATH=$(npm bin -g):$PATH — add this to your ~/.zshrc or ~/.bashrc.
agentmako doctor reports missing dependencies
Ensure you are running Node.js 20 or newer. Run 'node --version' to check. If using nvm, switch with 'nvm use 20'. Some features require pnpm — install it with 'npm install -g pnpm'.
context_packet returns empty or unhelpful results
Run 'agentmako connect . --no-db' again from your project root to re-index the codebase. If the project changed significantly since the last connect, the index may be stale. Check agentmako status . for index health.
Frequently Asked Questions about Codebase Intelligence
What is Codebase Intelligence?
Codebase Intelligence is a Model Context Protocol (MCP) server that 📇 🏠 🍎 🪟 🐧 - local-first codebase intelligence engine. gives coding agents structured context packets, i It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Codebase Intelligence?
Install via npm with the command: npx -y agentmako. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Codebase Intelligence?
Codebase Intelligence works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Codebase Intelligence free to use?
Yes, Codebase Intelligence is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Codebase Intelligence Alternatives — Similar Coding Agents Servers
Looking for alternatives to Codebase Intelligence? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Codebase Intelligence in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Codebase Intelligence?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.