Skip to content

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

Merged
JoshuaOliphant merged 1 commit into
mainfrom
chore/understand-mochi-donut-tools
Jul 18, 2026
Merged

docs(understand): document mochi-donut card/deck/attachment tools#22
JoshuaOliphant merged 1 commit into
mainfrom
chore/understand-mochi-donut-tools

Conversation

@JoshuaOliphant

Copy link
Copy Markdown
Owner

Summary

  • Documents the mochi-donut MCP server's full toolset in the understand plugin README: the existing fetch_url, list_decks, create_cards, plus six new tools landing in the paired mochi_donut PR (feat/card-management-tools): list_cards, get_card, update_card, create_deck, update_deck, add_attachment.
  • Bumps the understand plugin version 0.1.2 → 0.2.0 in plugin.json, marketplace.json, and the README title, to match.

This pairs with the feat/card-management-tools branch in mochi_donut, which adds the six new tools to the bundled MCP server (mochi_donut v0.4.0). That work was still in progress at the time of this PR; this documents the intended toolset ahead of that release.

Newly documented tools

  • 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, tags
  • update_card(card_id, content?, deck_id?, manual_tags?, archived?, trashed?) — edit/move/tag/archive/soft-delete a card
  • create_deck(name, parent_id?) — create a deck (optionally nested)
  • update_deck(deck_id, name?, parent_id?, archived?) — rename/re-parent/archive a deck
  • add_attachment(card_id, file_path, filename?) — upload an image attachment to a card

Test plan

  • python -m json.tool on plugin.json and marketplace.json — valid
  • python scripts/check_marketplace_versions.py — versions in sync
  • python scripts/sync_shared.py — shared artifacts unaffected
  • uv run pytest plugins/understand/tests -q — 8 passed

🤖 Generated with Claude Code

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 <noreply@anthropic.com>
@JoshuaOliphant
JoshuaOliphant marked this pull request as ready for review July 18, 2026 15:15
@JoshuaOliphant
JoshuaOliphant merged commit 3206cdd into main Jul 18, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant