# Kuuhaku

> Kuuhaku is an MCP server for developer tools. Ask which services call a route or break on a change, across a system's repositories. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** Web, CLI, API
- **Website:** https://kuuhaku.dev
- **MCP Registry name:** dev.kuuhaku/kuuhaku
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Kuuhaku scans a group of repositories and records how they talk to each other: HTTP routes, gRPC, queues, WebSockets and shared databases, each connection with the file and line on both sides. The MCP server lets a coding agent query that map before it edits, using tools such as who_calls and impact, so changes to a route or a model field are checked against callers in other repos.

The scan reads an architecture.yaml that names the repos and how each calls the others, and unresolved calls land in a review inbox where a click becomes a declaration. The same data drives a pull request check that reports removed routes, calls to routes that do not exist, queues that lose a publisher and dropped fields still read elsewhere. The site cites a measurement on 14 public systems.

It runs as an npm CLI over stdio or as the remote endpoint at api.kuuhaku.dev. The CLI can scan locally or in CI and upload only the graph, so source code stays on your machines. It also generates AGENTS.md files, C4 export and a personal-data map.

## Features

- **Cross-repo call map:** Shows every connection between services with file and line evidence.
- **Impact queries for agents:** who_calls and impact tools answer what a change affects.
- **Pull request check:** Flags broken callers, missing routes and orphaned queues.
- **Review inbox:** Unresolved calls get a suggested answer that persists across scans.
- **Graph-only upload:** The CLI sends names, paths and line numbers, not whole repositories.
- **Personal data map:** Tags model fields by LGPD and GDPR category from their names.

## Good for

- Find every caller before renaming a route
- Check a pull request for broken cross-service calls
- Give a coding agent context about other repos
- Document service architecture that updates on each import
- Export C4 diagrams

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http kuuhaku https://api.kuuhaku.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.kuuhaku.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kuuhaku": {
      "url": "https://api.kuuhaku.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kuuhaku": {
      "type": "http",
      "url": "https://api.kuuhaku.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kuuhaku": {
      "serverUrl": "https://api.kuuhaku.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kuuhaku": {
      "type": "http",
      "url": "https://api.kuuhaku.dev/mcp"
    }
  }
}
```

## Tools

- `who_calls`: Find which services call a route
- `impact`: Show what a change would affect

## FAQ

### Is there a free trial?

Yes, 14 days on every plan with no credit card, per the site.

### Does my code leave my network?

The CLI scans on your machines or CI and uploads only the graph.

### Which systems does the CLI run on?

Windows, macOS and Linux with Node 18 or newer.

### How is it priced?

By repository count rather than seats, with Starter, Team and larger tiers; amounts are not shown in the page text.

### Is Kuuhaku free?

Kuuhaku is a paid product with a free trial.

### How do I add Kuuhaku to Claude Code?

Run this command in your terminal: claude mcp add --transport http kuuhaku https://api.kuuhaku.dev/mcp

### What are the best alternatives to Kuuhaku?

The closest alternatives to Kuuhaku are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/kuuhaku
