Skip to content
Agentmart
Submit a tool

Misakanet

Failure-memory layer for coding agents: search evidence-rated failure lessons by error text.

Connector by Ikalus1988 · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)★ 543
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ikalus1988-misakanet

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Failure-memory layer for coding agents: search evidence-rated failure lessons by error text.

Use cases: debugging

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Runs code on install

Its package runs an install script (such as npm postinstall or setup.py code) as soon as you install it, before any tool is called. Read the script first.

Tools
10 read · 5 write · 0 delete · 2 not yet classified
Secrets
None asked for
Install scripts
Runs code on install
Runs as
Python package

Tools by what they do 17

Read from the source code; the running server may list different tools.

Read 10 · Look things up without changing anything.

  • deepseek.recovery.doctor
  • deepseek.recovery.get_lesson
  • deepseek.recovery.search
  • deepseek.recovery.status
  • misakanet_get_lesson
  • misakanet_me_events
  • misakanet_me_inbox
  • misakanet_preflight
  • misakanet_search
  • misakanet_usage_status

Write 5 · Create, change, send or run things.

  • deepseek.recovery.submit_feedback
  • misakanet_register
  • misakanet_submit_intake
  • misakanet_submit_usage
  • misakanet_write_lesson

Not yet classified 2 · We could not tell from the name and description.

  • deepseek.recovery.smoke
  • misakanet_memory_context

Files it touches

  • Any path the agent passes to its tools

Tools (17)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • deepseek.recovery.doctor

    Health check for the MisakaNet recovery plugin. Verifies: data files exist, search engine is built, MCP server is reachable. Input: none required. Output: health status with checks and recommendations.

  • deepseek.recovery.get_lesson

    Fetch a specific failure-recovery lesson by ID or path. Use after deepseek.recovery.search returns a match. Input: id or path (one required). Output: lesson content in markdown, truncated to 5000 chars.

  • deepseek.recovery.search

    Search MisakaNet's failure-lesson index for recovery guidance. Use when an error, exception, or failure occurs and you need a documented fix from real engineering sessions. Input: query (required), domain (optional), top (optional). Output: ranked lesson summaries with path, title, score.

  • deepseek.recovery.smoke

    Minimal smoke test: runs a search and lesson fetch. Use to verify the plugin works end-to-end. Input: none required. Output: pass/fail with timing and result counts.

  • deepseek.recovery.status

    Check MisakaNet recovery plugin status. Shows available lessons, search engine health, and usage quota. Input: none required. Output: status with lesson count, engine type, and quota.

  • deepseek.recovery.submit_feedback

    Record that a lesson helped with a failure. Use after applying a fix from a lesson. Input: lesson_id (required), outcome (solved/partial/not-helpful). Output: confirmation with lesson_id and status.

  • misakanet_get_lessonread-only

    [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. Provide exactly one of id or path (path takes precedence if both are supplied); if neither is supplied the tool returns {error}. `path` must be a lesson file (lessons/<topic>/<slug>.md) — anything else is refused with code=invalid_lesson_path rather than read. Returns: object {path: string, content: string} — lesson markdown body, capped at 5000 chars per call; or {error, code}. The code says which: lesson_not_found (no such l…

  • misakanet_me_eventsread-only

    [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 `verified by:` line are E3 hints: a citation is sandbox-level evidence, a vote is one person's opinion, and a provenance line is the lesson talking about itself, so none of them can confer E4. Use to check whether a lesson is proven by real usage, not just self-reported. Provide lesson_id or lesson_path — if neither is supplied…

  • misakanet_me_inboxread-only

    [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') from a prior misakanet_submit_intake response, or a dedup_key (the 16-char hash). Returns: {status: 'answered'|'pending'|'converted'|'not_found', ...} — 'answered' includes the maintainer's answer, 'converted' includes the lesson_id this intake became. Read-only, rate-limited, no auth required. Returns: object {intake_id, status, answer?, lesson_id?, issue_url?, note}. Example: misakanet_me_inbox(intake_id='issue-152…

  • misakanet_memory_context

    Proactive half of the pair: call this BEFORE starting a task so failure-memory is in context from the first step; call misakanet_search once a specific error has actually appeared. Input semantics: `task` is required and is matched as lexical keyword/token overlap over lesson titles, summaries and tags (BM25 when the index is present, a plain scorer otherwise) — not embeddings — so pass the concrete nouns, tools and error words you are about to meet ('chromadb on an NTFS mount', 'docker multi-stage build OOM') rather than a goal ('make it faster'); intent-only phrasing retrieves nothing. How `…

  • misakanet_preflightread-only

    [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. No side effects — safe to call multiple times before acting. **Requires a Bearer token** (`misakanet_register` first, and pass the same `client_id` to keep your node): an anonymous call is refused with JSON-RPC -32000 `Unauthorized` plus a `recovery` hint, which this sentence exists to keep you from discovering the hard way. Returns: object {risk_level: 'low'…

  • 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 speed limit, not a quota). No GitHub account or email needed, and no personal data is collected — the node is a pseudonym, not an account. Token lifetime: valid ~30 days. Pass client_id (a random UUID you generate once and keep private) to get the SAME node_id and token back on every later call and to renew them; without…

  • misakanet_searchread-only

    [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. For a known lesson ID or path, prefer misakanet_get_lesson — it skips ranking and returns the full content. detail controls progressive disclosure: compact (default, ~80 tok/lesson) for broad scans, summary (~200 tok) adds domain/tags/fix, full returns complete lesson data. FAQ: results may also include answered questions (type="faq", issue_url + answer) — if a maintainer already answered the …

  • 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, no Bearer — output is a GitHub issue (intake,mcp-intake,pending-review) for maintainer triage, NOT a merged lesson. Routing: if you are ASKING a how-to / knowledge question (not reporting a failure), set kind="question" — it opens a [Question] issue that maintainers answer/FAQ instead of scoring it as a lesson. If kind …

  • misakanet_submit_usage

    [Experimental] Record that a public lesson helped with a problem. Call this AFTER a lesson has been used and the outcome is known — use misakanet_usage_status to check remaining quota before submitting. Input semantics: lesson_id is required (the lesson that helped); tool names the calling client (e.g. 'claude-code', 'cursor'); outcome should be solved, partial, not-helpful, or another short status. Output schema: JSON with {lesson_id, tool, outcome, status}. Error cases: missing lesson_id. Side effects: currently returns a local placeholder report only (remote submission is disabled when MISA…

Show 2 more tools
  • misakanet_usage_status

    Check current usage status and remaining quota. Use before calling misakanet_submit_usage to see how many free lesson reads remain and whether registration is needed. Call misakanet_register if is_registered is false and you need write access. Input semantics: user is optional (defaults to 'anon:mcp-default'); pass the token from misakanet_register (e.g. 'token:xxx') to check a registered agent's quota. Output schema: JSON with {user, free_reads_used, free_reads_limit, free_reads_remaining, credits, is_registered, next}. Error cases: none (returns defaults on failure). Side effects: none. Auth…

  • 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 lesson-gate/lint/review and becomes a versioned lesson in the git repo. For quick open reports when you only have a partial failure description, use misakanet_submit_intake instead (no Bearer). Lessons are immutable once merged — corrections go through a new intake/PR, so there is intentionally no misakanet_update_lesson/mi…

Compare and alternatives

    Featured in

    Signals

    Stars
    543
    Forks
    224
    Open issues
    372
    Contributors
    101
    Weekly downloads
    842
    Last commit
    Oct 24, 2026 (4 days ago)
    Last release
    Oct 24, 2026 (4 days ago)
    Last package publish
    Oct 24, 2026 (4 days ago)

    From GitHub (fetched Oct 24, 2026) and the package registry.

    Details

    Registry name
    io.github.Ikalus1988/misakanet
    Version
    2.50.0
    Auth
    No auth
    Packages
    pypi misakanet
    License
    Apache-2.0
    Repository
    github.com/Ikalus1988/MisakaNet
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql

    More from Ikalus1988

    Cite this page

    Misakanet MCP server. Agent Mart. https://agentmart.dev/connectors/ikalus1988-misakanet (last updated 2026-10-24)