Misakanet
Failure-memory layer for coding agents: search evidence-rated failure lessons by error text.
At a glance
Not tested yet- GitHub stars
- 565
- Weekly downloads
- 1,526
- Last commit
- 2026-11-20
- Licence
- Apache-2.0
- Transport
- stdio
- Auth
- none
uvx misakanet
What it does
MisakaNet is a git-backed failure memory for AI coding agents. It stores lessons about errors and how they were fixed as Markdown files, graded by evidence and reviewed like code. An agent searches it when an error appears and applies a fix someone already verified. It is for people running coding agents who want past debugging knowledge reused instead of rediscovered.

Tools it gives your agent
The sources name only one tool, misakanet_search, which takes a query and a top count and returns matching lessons with their evidence_level and path, or no_match plus a ready-to-call intake.
Quick start
- Install the stdio server.
pip install misakanet
- Or point any MCP client at the public endpoint
https://misakanet.org/mcp, which allows anonymous reads. - Search for something you have broken. A hit returns the lesson, its
evidence_leveland its path. Read the file and the fix before running any command in it. - A miss returns
no_matchplus a ready-to-call intake. - Check the trust signal:
E0toE3say how far a lesson was verified, andE4is the one nobody can write or vote into.
Add it to Claude Code from a terminal:
claude mcp add misakanet -- uvx misakanet
Or add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"misakanet": {
"command": "uvx",
"args": [
"misakanet"
]
}
}
}Environment variables
MISAKANET_SEMANTIC: set to0to disable the hosted endpoint's optional semantic fallback.
Example prompts
- Search MisakaNet for "database is locked" and show me the top 3 lessons.
- A pip install times out behind a corporate proxy. Look for a lesson on this and read me the fix.
- Nothing matched my Docker error. Give me the intake so I can record it.
What to watch out for
- MisakaNet answers only for the failures it has indexed. When nothing matches, the reply is
no_matchplus an intake, not an answer. - The hosted endpoint is a subset of the local stdio server's tools.
- The semantic fallback runs only when BM25 returns no match, and it did not meet the R@1 target in the published 267-query run.
- Reported gaps arrive faster than they are triaged, and the intake queue is described as the bottleneck.
- The sources state no required account or token for the install paths.
Not tested by tools4agents yet. Read the source repository before you install it.
Similar tools
Everything
The official test server. Exercises every part of the protocol, so it is the fastest way to check your setup works at all.
Filesystem
Gives an agent scoped read and write access to directories you name explicitly. The usual first MCP server people install.
Git
Read, search, and manipulate local Git repositories. Lets an agent inspect history and diffs without shelling out.
Sequential Thinking
Gives a model a scratchpad for multi step reasoning, letting it revise earlier steps instead of committing to a first answer.