klypix-mcp

Tools

• list_canvasesList all .klypix / .any canvas files in the vault, with card and connection counts.
• read_canvasWhile the KLYPIX app (Windows) has the canvas open and lets AI tools use it, the canvas is read LIVE from KLYPIX: unsaved changes included, the person's view (lens, filters, collapsed boxes, what is on screen) and, for each card, whether th
• search_canvasesSearch card text, titles, #tags, KLYPIX labels and the readings KLYPIX saved on cards (transcripts of videos and reels) across every canvas in the vault. Returns the canvases and the matching cards with their ids and dates. Cards inside a b
• search_all_brainsCross-project memory search: looks through every brain.klypix this machine has REGISTERED, not just the current vault. Ranking is lexical, blended with on-device semantic similarity ONLY when the optional local model is installed (a fresh `
• brain_askAnswer a natural-language question from the WHOLE project brain — "what did we decide about X?", "where did the auth work land?", "why did we drop Y?". Ranks every card by meaning with the on-device model (installed by `npx klypix-mcp insta
• project_map_contextRead-only combined context for a coding question. It queries a provider-neutral, bounded view of the generated project graph (Graphify graphify-out/graph.json is supported first) and places that CURRENT CODE evidence beside fast, correction
• project_map_scanKLYPIX's own zero-install scanner: walks the repo (gitignore-aware, junk dirs like browser profiles and build output excluded), extracts FILE-LEVEL import edges for the JS/TS family (relative, tsconfig-alias, and monorepo-workspace imports
• project_map_driftRead-only drift check: every brain card that references THIS project's files is verified against the working tree. Reports cards whose referenced files are gone or moved (with rename candidates by unique basename), and headlines the checkou
• brain_challengeBEFORE committing to a significant decision, ask the brain to ARGUE BACK: prior decisions that deterministically contradict the claim (correction-cue / opposite-polarity evidence — never mere topical similarity), 🛠 standing rules that disp
• brain_insightsStructural read of a brain.klypix: the most-connected "hub" cards (load-bearing decisions), orphaned decisions (no connections — maybe forgotten), stale open questions (aging & unresolved), and area sizes. Use to answer "what matters here /
• brain_lensWhile the KLYPIX app (Windows) has the canvas open and lets AI tools use it, the freshness, provenance, activity, orrery and unresolved views come from KLYPIX itself — its own lens code over the cards this tool may see, the exact picture th
• brain_connectRepairs orphaned decision/milestone cards first (scope:"orphans", the default) by proposing genuinely related unlinked pairs — semantic similarity at a conservative 0.55 threshold when the on-device model is installed, else shared tags + [[
• brain_reconcileTruth maintenance. (1) CONTRADICTIONS: finds same-subject live card pairs where one carries an explicit correction cue (uppercase "CORRECTION", "was WRONG", "OBSOLETE" — that side is the presumed truth, UNLESS the cue predates its counterpa
• brain_gardenTidy an over-grown brain WITHOUT losing anything — SMART and non-invasive: it only consolidates DORMANT cards (old + peripheral), never load-bearing ones. Two phases: call it with no apply to get the areas that have accumulated forgotten ca
• create_canvasCreate a new .klypix canvas from cards + connections and save it to the vault. The user opens it in the KLYPIX app (Canvas → Open). Prefer short, titled cards (one idea each) connected by meaningful arrows. For anything a person reads IN OR
• add_to_canvasAppend cards (and optional connections) to an existing v4 .klypix, preserving all existing items and their positions. New cards are placed to the right of the current content, bordered and readable on KLYPIX's dark and Paper themes; a card
• klypix_statusCheck what KLYPIX can do for the user on this PC right now: whether the KLYPIX app is running, which canvases are open in it, where saved canvases are read from, and which KLYPIX features you may use and what each still needs from the user.
• read_card_contentsRead what is INSIDE cards on a KLYPIX canvas: a reel, YouTube video, web page, video or audio file, photo, PDF or Office file, text file, or folder. On a canvas open in the KLYPIX app (Windows) while it lets AI tools use it, KLYPIX reads th
• brain_noteRecord something in the project brain ON DEMAND — the agent-neutral twin of the Claude-Code capture hook, so any client (Cursor / Cline / Desktop) can write the brain, not just read it. Unlike add_to_canvas (a flat append), this routes thro
• brain_messageLeave a DELIBERATE, targeted note for another agent session working on this project ("merged the hook refactor — rebase before you commit", "don't touch canvasStore, mid-refactor"). Address it to a session id from the brain_sync peer list o
• brain_message_receiptExplicit durable receipt for a coordination note already offered into model-visible context and acknowledged by a later independent action. Call only after the note has actually been incorporated into the receiving agent's work. Requires th
• brain_reopenA note to a session that has CLOSED waits up to 7 days and is delivered only when that session is next used. When the human wants it handled sooner, call this: KLYPIX asks the HUMAN (an in-chat Reopen / Not now prompt where the app supports
• brain_handoffThe session handoff. On hosts without native transcript access, call {action:"capture", turns:[{id,role,at,text}]} as user requests and replies arrive, before writing a handoff. Capture only observed text with stable ids and known timestamp
• brain_syncAPPROVAL-FREE task gateway over the authorized MCP connection. Call FIRST with a concise intent and expected files, again when scope changes, and with phase:"complete" before the final response. One bounded response returns compact task-rel
• brain_rulesTurns lessons this brain recorded ("every new route must also be in PRIVATE_ROUTES", "a new *.test.ts must be listed in package.json", "this file is mixed CRLF/LF") into DETERMINISTIC diff checks, versioned in the repo as .klypix/rules.json
• brain_doctorRead-only self-check of the installed klypix brain, as ONE verdict: VERSION (deployed brain-core + optional npm currency), CLAUDE (existing 5-hook capture readiness), CODEX (automatic MCP presence plus optional enhanced-hook status), TOOLS
• canvas_viewRead any .klypix canvas/brain as a SPATIAL BOARD (defaults to the project brain): returns a text summary plus a structured render spec of cards, containers and connection arrows. It ALSO declares an MCP Apps (SEP-1865) UI resource, so a hos

Updated：2026-10-29 (tools/list verified)

Install

npx -y klypix-mcp@1.108.1

Configure in Claude / Cursor

{
  "mcpServers": {
    "klypix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "klypix-mcp@1.108.1"
      ]
    }
  }
}