@fredrika/mcp-mochi 2.1.0 → 2.3.0

package/dist/index.js

@@ -34,7 +34,7 @@ const CreateCardRequestSchema = z.object({
     content: z
         .string()
         .min(1)
-        .describe("Markdown content of the card. Separate the question and answer with a horizontal rule surrounded by newlines: '\\n---\\n'"),
+        .describe("Markdown content of the card. Separate the question and answer with a horizontal rule (3 dashes) surrounded by newlines: '\\n---\\n'. IMPORTANT: the dashes must be on an empty line."),
     deckId: z.string().min(1).describe("ID of the deck to create the card in"),
     templateId: z
         .string()
@@ -277,9 +277,9 @@ const GetDueCardsResponseSchema = z.object({
     cards: z.array(DueCardSchema).describe("Array of cards due for review"),
 });
 function getApiKey() {
-    const apiKey = process.env.API_KEY;
+    const apiKey = process.env.MOCHI_API_KEY;
     if (!apiKey) {
-        console.error("API_KEY environment variable is not set");
+        console.error("MOCHI_API_KEY environment variable is not set");
         process.exit(1);
     }
     return apiKey;
@@ -540,7 +540,7 @@ function formatToolError(error) {
 // Note: Using type assertions due to Zod version compatibility between SDK (v4) and project (v3)
 server.registerTool("create_flashcard", {
     title: "Create flashcard on Mochi",
-    description: "Create a new flashcard in Mochi. Look up deckId with list_decks first. Use create_card_from_template if the deck has a template-id defined.",
+    description: "Create a new flashcard in Mochi. Look up deckId with list_decks first. Use create_card_from_template if the deck has a template-id defined. IMPORTANT: To add images/audio/files: 1) Create the card (include placeholder with id like '![](ChWupMjQ.png)' in content), 2) Use add_attachment with the returned card ID to upload the file with the matching id.",
     inputSchema: CreateCardRequestSchema,
     outputSchema: CreateCardResponseSchema,
     annotations: {
@@ -666,7 +666,7 @@ server.registerTool("archive_flashcard", {
 });
 server.registerTool("add_attachment", {
     title: "Add attachment to flashcard on Mochi",
-    description: "Add an attachment (image, audio, etc.) to a card using base64 data. For URL-based images, just use markdown directly in card content instead.",
+    description: "Upload an attachment (image, audio, etc.) to an EXISTING card using base64 data. The card content must already include the markdown reference '![](@media/filename)' where filename matches the uploaded file. Workflow: 1) Create card with create_flashcard (include '![](@media/filename.png)' in content), 2) Upload file with this tool using the card ID and matching filename. For URL-based images, just use standard markdown in card content instead.",
     inputSchema: AddAttachmentSchema,
     outputSchema: AddAttachmentResponseSchema,
     annotations: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fredrika/mcp-mochi",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "MCP server for Mochi flashcard integration",
   "main": "dist/index.js",
   "type": "module",