# Mushi Mushi

> Mushi Mushi is a freemium MCP server for developer tools. Bug reports to fix context, draft pull requests and merges from Cursor or Claude Code. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** CLI, API, Web
- **Website:** https://kensaur.us/mushi-mushi/docs/quickstart/mcp
- **Repository:** https://github.com/kensaurus/mushi-mushi/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.kensaurus/mushi-mushi
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Mushi Mushi collects bug reports from apps built with AI tools and turns each into a plain-English diagnosis. Its MCP server brings that into the editor: an agent can read a report with evidence, similar bugs and blast radius, get the smallest set of files needed for a fix, and dispatch a fix that opens a draft pull request, then merge it and close the report.

The default catalogue is lean, and the full set has 133 tools plus resources, selectable by feature groups (triage, fixes, inventory, setup, docs). It runs over stdio from npm with an API key scoped for read or write, or via a hosted Streamable HTTP endpoint. Hosted Mushi Mushi has a built-in fixer, while Cursor agents need the user's own key.

The free plan covers one app and up to 100 bugs explained a month; Builder is $29 a month for up to three apps.

## Features

- **Report triage:** Evidence, similar bugs and next actions per report.
- **Fix context:** Root cause, repro and smallest relevant file set.
- **Dispatch and merge fixes:** Draft PR, then merge and close.
- **Setup diagnosis:** Explains a broken install.
- **Feature groups:** Choose which tool groups to expose.

## Good for

- Pull the latest bug into Cursor with fix context
- Hand a bug fix to an agent as a draft PR
- Debug a failing Mushi install
- Answer SDK setup questions from docs

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mushi-mushi https://kensaur.us/mushi-mushi/hosted-mcp/
```

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

```sh
https://kensaur.us/mushi-mushi/hosted-mcp/
```

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

```json
{
  "mcpServers": {
    "mushi-mushi": {
      "url": "https://kensaur.us/mushi-mushi/hosted-mcp/"
    }
  }
}
```

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

```json
{
  "servers": {
    "mushi-mushi": {
      "type": "http",
      "url": "https://kensaur.us/mushi-mushi/hosted-mcp/"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mushi-mushi": {
      "serverUrl": "https://kensaur.us/mushi-mushi/hosted-mcp/"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mushi-mushi": {
      "type": "http",
      "url": "https://kensaur.us/mushi-mushi/hosted-mcp/"
    }
  }
}
```

## Tools

- `get_fix_context`: Root cause, repro and the smallest set of files for a report.
- `triage_issue`: Evidence, similar bugs, blast radius, logs and next actions for a report.
- `triage_next_steps`: Suggested next triage steps.
- `dispatch_fix`: Have an agent open a draft pull request.
- `merge_fix`: Merge the fix and close the report.
- `diagnose_setup`: Explain a broken install and the next step.
- `search_mushi_docs`: Answer setup and API questions from the docs.
- `summarize_report_for_fix`: Summarize a report for fixing.

## FAQ

### How many tools are there?

The full catalogue has 133, with a leaner default.

### What does it cost?

Free for one app (100 bugs a month); Builder $29/month for up to 3 apps.

### What key is needed?

A MUSHI_API_KEY with mcp:read, or mcp:write to dispatch fixes.

### Can it be self-hosted?

MUSHI_API_ENDPOINT can point at a self-hosted deployment.

### Is Mushi Mushi free?

Mushi Mushi has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

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

Run this command in your terminal: claude mcp add --transport http mushi-mushi https://kensaur.us/mushi-mushi/hosted-mcp/

### What are the best alternatives to Mushi Mushi?

The closest alternatives to Mushi Mushi 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/mushi-mushi
