Skip to content
MCP server

Kuuhaku

Ask which services call a route or break on a change, across a system's repositories

Install
Pricing
Free trial
Platforms
Web, CLI, API
Runs
Locally or Remotely
Version
0.2.10
Listing updated
2 days ago

About Kuuhaku

Kuuhaku is an MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.kuuhaku.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kuuhaku": {
      "url": "https://api.kuuhaku.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free trial

14-day free trial, no card; priced per organisation by repo count

Prices change. Check kuuhaku.dev before you buy.

Kuuhaku 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 to Kuuhaku

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools