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

curl -X POST https://your-domain.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -H "x-mochi-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Local Development

Installation

npm install

Development Server

npm run dev

Build

npm run build

Stdio Mode (Claude Desktop)

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

Build stdio version

npm run build:stdio

Claude Desktop Configuration

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

{
  "mcpServers": {
    "mochi": {
      "command": "node",
      "args": ["/path/to/mochi-mcp-server/dist/stdio.js"],
      "env": {
        "MOCHI_API_KEY": "your-api-key-here"
      }
    }
  }
}

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:

What is the capital of France?
---
Paris

Bulk Card Creation

{
  "method": "tools/call",
  "params": {
    "name": "create_cards_bulk",
    "arguments": {
      "deck_id": "deck-id",
      "cards": [
        { "content": "Question 1\n---\nAnswer 1" },
        { "content": "Question 2\n---\nAnswer 2", "tags": ["tag1", "tag2"] }
      ]
    }
  }
}

Notes

• Mochi API only accepts one concurrent request per account
• Be aware of rate limits (429 error)
• Deck deletion cannot be undone

License

ISC