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

View on GitHub

Install

From registry metadata

$ npx add-mcp https://misakanet.org/mcp --name misakanet

Run 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/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 8 tools

Verified 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_typestring

Agent 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_idstring

Optional 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_weightnumber

Override baseline score weight (0-1). Higher favors proven/popular lessons. Default: 0.15.

bm25_weightnumber

Override BM25 keyword weight (0-1). Higher favors exact keyword match. Default: 0.65. All weights must sum to 1.0.

detailstring

Progressive 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 · full

domainstring

Optional domain filter such as devops, python, network, feishu, rag, fanuc, or mcp.

kindstring

Filter 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 · related

metadata_weightnumber

Override metadata bonus weight (0-1). Higher favors matching domain/tags. Default: 0.20.

query*string

Required redacted error message, keyword, or topic (e.g. 'pip install timeout' or 'DCO sign-off failed').

topinteger

Maximum 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

idstring

Lesson ID, usually the filename without .md, e.g. auto-merge-ci-pipeline. Either id or path is required.

pathstring

Lesson 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

contributorstring

Optional: contributor identity (GitHub username, agent name, or email). Included in issue body for attribution.

errorstring

Optional: short error message (auto-redacted).

fixstring

Optional: how it was resolved.

kindstring

missing_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_idstring

Optional: lesson ID that was checked but didn't help.

notify_emailstring

Optional: 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*string

Required: the symptom first, then `## Root Cause` and `## Fix` sections when known (max 2000 chars). Reports with those sections can become lessons automatically.

sourcestring

Calling client: codex, claude-code, cursor, dsh, curl, cindy, or other.

verificationstring

Optional: how to confirm the fix works.

what_triedstring

Optional: 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

contributorstring

Optional: contributor identity (GitHub username, agent name, or email). Included in lesson frontmatter for attribution.

domain*string

Domain: devops, python, network, feishu, rag, fanuc, mcp, etc.

fix*string

How to fix it (required).

problem*string

What failed (required).

root_cause*string

Why it failed (required).

sourcestring

Source: codex, claude-code, cursor, dsh, curl, cindy, etc.

tagsstring

Comma-separated tags.

title*string

Short descriptive title.

verificationstring

How 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

contextstring

Optional: additional context about the environment or setup.

intent*string

Required: 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_idstring

Lesson ID (filename stem), e.g. dco-auto-fix-workflow. Either lesson_id or lesson_path is required.

lesson_pathstring

Optional 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_keystring

The dedup_key (8-char FNV-1a hex key) from a prior submit_intake response. Either intake_id or dedup_key is required.

intake_idstring

Question 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.

Readme

English | 日本語 | 简体中文 | ＋你的语言

MisakaNet

mcp-name: io.github.Ikalus1988/misakanet

The same failure, paid for twice.

A pip install times 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.

View the full README on GitHub

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

Related AI & LLM Tools MCP servers

View all

Vibe Check Mcp Serverpv-bhat/vibe-check-mcp-serverMetacognitive AI agent oversight: adaptive CPI interrupts for alignment, reflection and safety488stars

Clawdcursoramrdab/clawdcursorSafe cross-OS desktop control for any AI agent - the fallback execution layer.408stars

MCP Alchemy Serverrunekaagaard/mcp-alchemyA MCP (model context protocol) server that gives the LLM access to and knowledge about relational databases like SQLite, Postgresql, MySQL & MariaDB, Oracle, an403stars

SkillPortgotalab/skillportProvides an MCP interface to discover, load, and execute agent skills on demand.385stars

agentringmutonby/agentringLet your AI agent message and call your Android phone, and get your reply or the call transcript.376stars

VS Codejuehang/vscode-mcp-serverMCP server to expose VS Code editing features to an LLM for AI coding363stars