# MisakaNet MCP server

> Search a git-backed library of failure lessons by error text so coding agents skip bugs already solved.

- Listing: https://mcp.tc/i/misakanet
- Connect: use the server's own URL `https://misakanet.org/mcp` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: none
- Category: [Developer Tools](https://mcp.tc/c/developer-tools)
- Vendor: Ikalus1988
- Homepage: <https://misakanet.org>
- Repository: <https://github.com/Ikalus1988/MisakaNet>
- Package: pypi `misakanet`

## About

MisakaNet is a failure-memory layer for coding agents. It indexes failure-recovery lessons from real debugging sessions, each graded by evidence level. Agents can search by error text, fetch a full lesson, run a risk check before risky operations, and submit new lessons or intake reports when nothing matches.

It runs as a hosted streamable HTTP endpoint at https://misakanet.org/mcp, and also as a local stdio package (pip install misakanet). Searching and reading lessons needs no sign-in or token. Registering returns a Bearer token valid about 30 days, which raises rate limits and unlocks writing structured lessons.

## What it can do

- Search failure lessons by error text, keyword or topic
- Fetch the full content of a lesson by ID or path
- Check risk level of an intended operation before running it
- Submit open intake reports or questions for maintainer triage
- Write structured lessons with a Bearer token
- Check reuse evidence for a lesson
- Register a pseudonymous node to get a token

## Tools (8)

- `misakanet_register`: Get a Bearer token valid about 30 days that unlocks writing and higher rate limits.
- `misakanet_search`: Search the public failure-lesson index by error text, keyword or topic. (read-only)
- `misakanet_get_lesson`: Fetch one lesson's markdown content by repository path or lesson ID. (read-only)
- `misakanet_submit_intake`: Open a triage issue with a partial failure report or a question, no token needed.
- `misakanet_write_lesson`: Submit a structured failure lesson for review; requires a Bearer token.
- `misakanet_preflight`: Check the risk level of an intended operation against known lesson triggers. (read-only)
- `misakanet_me_events`: Return reuse evidence for a lesson: votes, citations and cross-node confirmation. (read-only)
- `misakanet_me_inbox`: \[AGENT READABLE INBOX\] Check the status of a previously submitted intake (question, missing\_lesson, etc.) without re-submitting. (read-only)

## Example prompts

- "Search MisakaNet for the lesson on 'database locked' SQLite errors on NTFS"
- "Run a preflight check before I build a RAG pipeline with ChromaDB"
- "Get the full MisakaNet lesson for this pip timeout error"
- "Submit an intake to MisakaNet describing this Docker build failure and the fix I found"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http misakanet https://misakanet.org/mcp
```

2. Start Claude Code and type `/mcp`. **misakanet** should show as connected.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **MisakaNet** and paste this URL:

```url
https://misakanet.org/mcp
```

3. Click **Add**. Its tools appear in the chat’s tools menu.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=MisakaNet&connectorUrl=https%3A%2F%2Fmisakanet.org%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://misakanet.org/mcp` and click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://misakanet.org/mcp` as the server URL, then for authentication choose **No authentication**.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=misakanet&config=eyJ1cmwiOiJodHRwczovL21pc2FrYW5ldC5vcmcvbWNwIn0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "misakanet": {
      "url": "https://misakanet.org/mcp"
    }
  }
}
```

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=misakanet&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmisakanet.org%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"misakanet","type":"http","url":"https://misakanet.org/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "misakanet": {
      "type": "http",
      "url": "https://misakanet.org/mcp"
    }
  }
}
```

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "misakanet": {
      "serverUrl": "https://misakanet.org/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add misakanet --url https://misakanet.org/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.misakanet]
url = "https://misakanet.org/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http misakanet https://misakanet.org/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "misakanet": {
      "type": "http",
      "url": "https://misakanet.org/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://misakanet.org/mcp`.

## Recent changes

- 2026-11-17 17:51 UTC: New version 3.19.0 (was 3.18.0), reported by the server. Source: automatic check.
- 2026-11-16 11:57 UTC: 1 tool changed. Source: automatic check. Changed: misakanet\_submit\_intake.
- 2026-11-16 08:52 UTC: New version 3.18.0 (was 3.17.0), reported by the server. Source: automatic check.
- 2026-11-14 17:57 UTC: New version 3.16.0 (was 3.15.0), reported by the server. Source: automatic check.
- 2026-11-13 14:51 UTC: New version 3.14.0 (was 3.11.3), reported by the server. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/misakanet#history (Atom feed: https://mcp.tc/i/misakanet/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 3.19.0
- MCP protocol version: 2026-07-28
- Last checked: 2026-11-18 (reachable)
- Listed: 2026-10-13
- Updated: 2026-11-04

---
Source: https://mcp.tc/i/misakanet (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
