From 8ee9555cab17a35669586c3df6d2bfbd9753066b Mon Sep 17 00:00:00 2001 From: Joshua Oliphant Date: Fri, 17 Jul 2026 22:16:13 -0700 Subject: [PATCH] docs(understand): document mochi-donut card/deck/attachment tools The bundled mochi-donut MCP server is gaining six tools (list_cards, get_card, update_card, create_deck, update_deck, add_attachment) alongside the existing fetch_url/list_decks/create_cards. Document the full toolset in the understand plugin README and bump its version to reflect the new capability surface. Co-Authored-By: Claude Fable 5 --- .claude-plugin/marketplace.json | 2 +- plugins/understand/.claude-plugin/plugin.json | 2 +- plugins/understand/README.md | 16 ++++++++++++++-- 3 files changed, 16 insertions(+), 4 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index dbbd1c6..93a6ad2 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -128,7 +128,7 @@ "name": "understand", "source": "./plugins/understand", "description": "Process information for real understanding with the explain-back skill: explain from memory, grade against the real source, struggle-then-teach per gap, output Mochi cards and a resumable session record. An antidote to the illusion of clarity.", - "version": "0.1.2", + "version": "0.2.0", "author": { "name": "Joshua Oliphant" }, diff --git a/plugins/understand/.claude-plugin/plugin.json b/plugins/understand/.claude-plugin/plugin.json index e6a2def..f257642 100644 --- a/plugins/understand/.claude-plugin/plugin.json +++ b/plugins/understand/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "understand", - "version": "0.1.2", + "version": "0.2.0", "description": "Process information for real understanding. The explain-back skill makes you explain from memory, grades against the real source, teaches only after you attempt, and outputs Mochi cards plus a resumable session record. An antidote to the illusion of clarity.", "license": "MIT", "author": { diff --git a/plugins/understand/README.md b/plugins/understand/README.md index 994c1f3..a33ef0b 100644 --- a/plugins/understand/README.md +++ b/plugins/understand/README.md @@ -1,4 +1,4 @@ -# understand (v0.1.0) +# understand (v0.2.0) Process information for real understanding — an antidote to the illusion of clarity (the confident feeling of understanding something whose grasp is actually full of gaps). @@ -35,7 +35,19 @@ Defaults: `session_dir` `understand-sessions/`, `follow_references` true, `stric ## Requirements The plugin **bundles** the [`mochi-donut`](https://github.com/JoshuaOliphant/mochi_donut) MCP -server via `.mcp.json`, so installing the plugin registers it automatically. You need: +server via `.mcp.json`, so installing the plugin registers it automatically. It exposes: + +- `fetch_url(url, format?)` — fetch a URL and convert it to clean markdown via JinaAI Reader +- `list_decks()` — list all Mochi decks with their IDs +- `create_cards(deck_id, cards)` — create one or more flashcards in a deck +- `list_cards(deck_id?, limit?, bookmark?)` — list cards, optionally filtered by deck, paginated via bookmark +- `get_card(card_id)` — fetch one card's full content, deck, and tags +- `update_card(card_id, content?, deck_id?, manual_tags?, archived?, trashed?)` — edit, move, tag, archive, or soft-delete a card +- `create_deck(name, parent_id?)` — create a deck (optionally nested under a parent) +- `update_deck(deck_id, name?, parent_id?, archived?)` — rename, re-parent, or archive a deck +- `add_attachment(card_id, file_path, filename?)` — upload an image attachment (png/jpg/jpeg/gif/svg/webp) to a card, referenced in card content as `![](@media/)` + +You need: - **`uv`** installed — the server is launched with `uvx` from the public repo. - **`MOCHI_API_KEY`** set in your environment — the mochi-donut server reads it to call the Mochi API.