Mochi MCP Server

An MCP server for creating and managing Mochi Cards flashcards via AI.

Supports both HTTP/SSE (for Vercel deployment) and stdio (for local use with Claude Desktop).

Features

Card Operations

• create_card - Create a new card

• get_card - Get card details

• list_cards - List cards

• update_card - Update a card

• delete_card - Delete a card

• add_attachment - Add attachment to a card

• delete_attachment - Delete attachment

• create_cards_bulk - Create multiple cards at once

Deck Operations

• create_deck - Create a new deck

• get_deck - Get deck details

• list_decks - List all decks

• update_deck - Update a deck

• delete_deck - Delete a deck

Template Operations

• create_template - Create a new template

• get_template - Get template details

• list_templates - List all templates

Review

• get_due_cards - Get cards due for review

Deployment

Deploy to Vercel

1. Click the deploy button above

2. Set the MOCHI_API_KEY environment variable

3. Deploy

API Endpoints

• GET / - Server info page

• POST /api/mcp - MCP JSON-RPC endpoint

• GET /api/mcp/sse - SSE endpoint for streaming connections

• POST /api/mcp/sse - SSE message endpoint

Example Request

Local Development

Installation

Development Server

Build

Stdio Mode (Claude Desktop)

For local use with Claude Desktop, use the stdio transport:

Build stdio version

Claude Desktop Configuration

Add the following to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

Getting Mochi API Key

1. Log in to Mochi Cards

2. Go to Account Settings → API to get your API key

Usage

Creating Cards

Card content is in Markdown format. Use --- to separate front and back:

Bulk Card Creation

Notes

• Mochi API only accepts one concurrent request per account

• Be aware of rate limits (429 error)

• Deck deletion cannot be undone

License

ISC