docs(understand): document mochi-donut card/deck/attachment tools

.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"
       },

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": {

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/<filename>)`
+
+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.