Misakanet
ikalus1988/misakanet
Failure-memory layer for coding agents: search evidence-rated failure lessons by error text.
- GitHub stars
- 561
- tools
- 8
- transport
- STDIO, HTTP
- last updated
- Nov 12, 2026
Install
From registry metadata$ npx add-mcp https://misakanet.org/mcp --name misakanetRun in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http misakanet https://misakanet.org/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 8 toolsVerified live against the running server on Nov 13, 2026.
misakanet_register[ONBOARDING] Get a Bearer token for authenticated access (unlocks misakanet_write_lesson and higher rate limits). Reading needs no registration and has no daily cap: misakanet_search / misakanet_get_lesson work anonymously (a per-address burst limit protects the index; it is a...2 params
[ONBOARDING] Get a Bearer token for authenticated access (unlocks misakanet_write_lesson and higher rate limits). Reading needs no registration and has no daily cap: misakanet_search / misakanet_get_lesson work anonymously (a per-address burst limit protects the index; it is a...
Parameters* required
agent_typestringAgent type (e.g. claude-code, codex, cursor, dsh, other). Optional: an omitted value is recorded as "unknown", the same default the local surface has always used.
client_idstringOptional stable identifier for this client (8-64 chars of A-Z a-z 0-9 . _ : -). Generate it once and reuse it so later calls return the same node instead of a new one.
misakanet_search[RETRIEVAL / READ] Search MisakaNet's public failure-lesson index by error text, keyword, or topic. This is the primary read path — run it first when you hit an error, before deciding to submit anything. Choosing among the retrieval tools: an actual error or keyword in hand →...8 params
[RETRIEVAL / READ] Search MisakaNet's public failure-lesson index by error text, keyword, or topic. This is the primary read path — run it first when you hit an error, before deciding to submit anything. Choosing among the retrieval tools: an actual error or keyword in hand →...
Parameters* required
baseline_weightnumberOverride baseline score weight (0-1). Higher favors proven/popular lessons. Default: 0.15.
bm25_weightnumberOverride BM25 keyword weight (0-1). Higher favors exact keyword match. Default: 0.65. All weights must sum to 1.0.
detailstringProgressive disclosure: compact (default, ~80 tok) includes id/title/problem/freshness/score; summary (~200 tok) adds domain/tags/fix; full returns complete lesson data with path.one of
compact · summary · fulldomainstringOptional domain filter such as devops, python, network, feishu, rag, fanuc, or mcp.
kindstringFilter by kind: 'lessons' (lesson files only), 'evidence' (results with evidence_refs or verification), 'related' (cross-referenced/tag-overlap), 'all' (default). Auto-detected from query intent wh...one of
all · lessons · evidence · relatedmetadata_weightnumberOverride metadata bonus weight (0-1). Higher favors matching domain/tags. Default: 0.20.
query*stringRequired redacted error message, keyword, or topic (e.g. 'pip install timeout' or 'DCO sign-off failed').
topintegerMaximum ranked results to return. Defaults to 5; keep small for MCP context and latency.
misakanet_get_lesson[RETRIEVAL / READ] Fetch one public MisakaNet lesson by repository path or lesson ID. Use after misakanet_search returns a promising result to pull the full fix content. Pass `path` or `id` (path wins if both are supplied); at least one is required, and the empty call returns...2 params
[RETRIEVAL / READ] Fetch one public MisakaNet lesson by repository path or lesson ID. Use after misakanet_search returns a promising result to pull the full fix content. Pass `path` or `id` (path wins if both are supplied); at least one is required, and the empty call returns...
Parameters* required
idstringLesson ID, usually the filename without .md, e.g. auto-merge-ci-pipeline. Either id or path is required.
pathstringLesson path relative to the repository, e.g. lessons/core/auto-merge-ci-pipeline.md — must be a file under lessons/ ending in .md (other repository files are not readable through this tool). Either...
misakanet_submit_intake[OPEN TRIAGE / INTAKE] Use misakanet_submit_intake when you only have a partial failure description or want to ask a question; use misakanet_write_lesson (Bearer required) once you already have structured title/domain/problem/root_cause/fix. submit_intake is open, rate-limited...10 params
[OPEN TRIAGE / INTAKE] Use misakanet_submit_intake when you only have a partial failure description or want to ask a question; use misakanet_write_lesson (Bearer required) once you already have structured title/domain/problem/root_cause/fix. submit_intake is open, rate-limited...
Parameters* required
contributorstringOptional: contributor identity (GitHub username, agent name, or email). Included in issue body for attribution.
errorstringOptional: short error message (auto-redacted).
fixstringOptional: how it was resolved.
kindstringmissing_lesson (knowledge gap), stale_lesson (outdated lesson), new_lesson_candidate (new failure mode), question (ask for help), or proposal (a plan / product request that is explicitly not a fail...
matched_lesson_idstringOptional: lesson ID that was checked but didn't help.
notify_emailstringOptional: an email for the ANSWER only, and only for kind="question". Ask the user first — never invent it. It is used to send one confirmation message now and, once confirmed, one notification whe...
problem*stringRequired: the symptom first, then `## Root Cause` and `## Fix` sections when known (max 2000 chars). Reports with those sections can become lessons automatically.
sourcestringCalling client: codex, claude-code, cursor, dsh, curl, cindy, or other.
verificationstringOptional: how to confirm the fix works.
what_triedstringOptional: what was attempted.
misakanet_write_lesson[STRUCTURED COMMIT / VALIDATED SUBMISSION] Submit a complete, structured failure lesson (title/domain/problem/root_cause/fix) as a formal submission. Requires authentication (Bearer token in header) — this is the 'validated author' path, not open triage. Output goes through le...9 params
[STRUCTURED COMMIT / VALIDATED SUBMISSION] Submit a complete, structured failure lesson (title/domain/problem/root_cause/fix) as a formal submission. Requires authentication (Bearer token in header) — this is the 'validated author' path, not open triage. Output goes through le...
Parameters* required
contributorstringOptional: contributor identity (GitHub username, agent name, or email). Included in lesson frontmatter for attribution.
domain*stringDomain: devops, python, network, feishu, rag, fanuc, mcp, etc.
fix*stringHow to fix it (required).
problem*stringWhat failed (required).
root_cause*stringWhy it failed (required).
sourcestringSource: codex, claude-code, cursor, dsh, curl, cindy, etc.
tagsstringComma-separated tags.
title*stringShort descriptive title.
verificationstringHow to confirm the fix works.
misakanet_preflight[GUARD / RISK CHECK] Check risk level before executing high-risk operations. Matches agent intent against lesson triggers to provide proactive warnings. Use before RAG builds, WSL/GPU tasks, bulk imports, or any operation that might fail. Choosing among the retrieval tools: no...2 params
[GUARD / RISK CHECK] Check risk level before executing high-risk operations. Matches agent intent against lesson triggers to provide proactive warnings. Use before RAG builds, WSL/GPU tasks, bulk imports, or any operation that might fail. Choosing among the retrieval tools: no...
Parameters* required
contextstringOptional: additional context about the environment or setup.
intent*stringRequired: what you plan to do (e.g. 'build RAG pipeline with ChromaDB').
misakanet_me_events[READ-ONLY EVIDENCE] Return evidence of a lesson being reused. E4 is observed reuse: `search_signals` shows two or more distinct clients actually retrieved the lesson — a count of requests, never of prose. Regression-benchmark citations, helpful votes and a lesson's own `verif...2 params
[READ-ONLY EVIDENCE] Return evidence of a lesson being reused. E4 is observed reuse: `search_signals` shows two or more distinct clients actually retrieved the lesson — a count of requests, never of prose. Regression-benchmark citations, helpful votes and a lesson's own `verif...
Parameters* required
lesson_idstringLesson ID (filename stem), e.g. dco-auto-fix-workflow. Either lesson_id or lesson_path is required.
lesson_pathstringOptional full path, e.g. lessons/core/dco-auto-fix-workflow.md. Either lesson_id or lesson_path is required.
misakanet_me_inbox[AGENT READABLE INBOX] Check the status of a previously submitted intake (question, missing_lesson, etc.) without re-submitting. Accepts an intake_id (e.g. 'issue-1234' or '1234') for question intakes, or a dedup_key (the 8-char FNV-1a key from a prior submit_intake response)...2 params
[AGENT READABLE INBOX] Check the status of a previously submitted intake (question, missing_lesson, etc.) without re-submitting. Accepts an intake_id (e.g. 'issue-1234' or '1234') for question intakes, or a dedup_key (the 8-char FNV-1a key from a prior submit_intake response)...
Parameters* required
dedup_keystringThe dedup_key (8-char FNV-1a hex key) from a prior submit_intake response. Either intake_id or dedup_key is required.
intake_idstringQuestion intake ID from a prior submit_intake response, e.g. 'issue-1528' or '1528'; for non-question intakes use dedup_key. Either intake_id or dedup_key is required.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageReadme
MisakaNet
mcp-name: io.github.Ikalus1988/misakanet
The same failure, paid for twice.
A
pip installtimes out behind a corporate proxy. An agent finds the fix. Days later the same timeout appears on another machine, under another model — and is debugged from scratch, because the fix was never written down anywhere the next agent looks.MisakaNet is that place: a git-backed failure memory. Every lesson is a Markdown file in this repository — graded by evidence, reviewed like code, retrieved by an agent instead of guessed at. You fail once; the next agent does not.
Agent-native interfaces: MCP server (8 tools), WebMCP, llms.txt,
A2A discovery via .well-known/agent-card.json. The local stdio server (pip install misakanet)
ships 11 — the hosted endpoint is a subset; docs/mcp.md has both rows.
Details
- Repository
- github.com/ikalus1988/misakanet
- Categories
- AI & LLM Tools, Search & Web Crawling
- Package
misakanet- Transport
- STDIO, HTTP
- Registry
- MCP registry, active
- Tools verified
- Nov 13, 2026
