Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MOCHI_API_KEY | Yes | Your Mochi API key (get it from Mochi app: Settings → Account → API Key) | |
| MOCHI_ALLOW_DECK_DELETE | No | Enable deck deletion | false |
| MOCHI_TOKEN_EXPIRY_MINS | No | Preview token validity in minutes | 10 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_decks | List all Mochi flashcard decks |
| get_deck | Get deck details and list of cards |
| get_card | Get full content of a single card |
| get_cards | Get content of multiple cards (bulk) |
| search_cards | Search cards by content, tags, or date. Returns rich results with deckId, createdAt, updatedAt. Includes scannedCount and truncated flags. |
| list_cards_page | Fetch a single page of cards with explicit pagination. Use for iterating through large collections. |
| find_deck_by_name | Find decks by name (case-insensitive partial match). Useful when you know the deck name but not its ID. |
| add_tags_preview | Preview adding tags to one or more cards. Returns a token for apply_tags_update. |
| remove_tags_preview | Preview removing tags from one or more cards. Returns a token for apply_tags_update. |
| apply_tags_update | Apply tag changes after user confirms. Use with token from add_tags_preview or remove_tags_preview. |
| create_card_preview | Preview a new card. IMPORTANT: After calling this, you MUST show the preview to the user and ask for explicit confirmation before calling apply_create_card. Do NOT chain these calls automatically. |
| apply_create_card | Execute card creation after user confirms |
| update_card_preview | Preview changes to a card with diff. IMPORTANT: After calling this, you MUST show the diff to the user and ask "Do you want to apply this change?" WAIT for explicit confirmation before calling apply_update_card. |
| update_card_fields_preview | Preview changes to specific fields (Question, Answer, Tags). Reconstructs full markdown. |
| update_cards_batch_preview | Preview updates for multiple cards at once. |
| apply_update_cards_batch | Apply a batch of card updates. |
| apply_update_card | Execute card update after user confirms |
| delete_card | Delete a card (soft-delete by default). Requires typed confirmation. |
| create_deck | Create a new deck |
| delete_deck | Delete a deck (disabled by default, requires MOCHI_ALLOW_DECK_DELETE=true) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| mochi_guide | Detailed user guide for Mochi MCP tools and workflows |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |