codecks-mcp

Instructions

Implementation Reference

• src/tools/read.ts:193-219 (registration)

  Tool registration for 'list_decks' - defines the schema (include_card_counts boolean parameter), metadata (title, description), and the handler that calls client.listDecks().
  server.registerTool( "list_decks", { title: "List Decks", description: "List all decks. Set include_card_counts=True for per-deck counts.", inputSchema: z.object({ include_card_counts: z.boolean().default(false), }), }, async (args) => { try { const result = await client.listDecks(args.include_card_counts); return { content: [{ type: "text", text: JSON.stringify(finalizeToolResult(result)) }], }; } catch (err) { return { content: [ { type: "text", text: JSON.stringify(finalizeToolResult(handleError(err))), }, ], }; } }, );
• src/tools/read.ts:202-218 (handler)

  Handler function for list_decks tool - executes the tool logic by calling client.listDecks() with the include_card_counts argument, wraps result in finalizeToolResult, and handles errors.
  async (args) => { try { const result = await client.listDecks(args.include_card_counts); return { content: [{ type: "text", text: JSON.stringify(finalizeToolResult(result)) }], }; } catch (err) { return { content: [ { type: "text", text: JSON.stringify(finalizeToolResult(handleError(err))), }, ], }; } },
• src/tools/read.ts:198-200 (schema)

  Input schema definition for list_decks tool - defines include_card_counts as an optional boolean parameter with default value false using zod validation.
  inputSchema: z.object({ include_card_counts: z.boolean().default(false), }),
• src/client.ts:198-212 (handler)

  Core implementation of listDecks method in CodecksClient - builds GraphQL-like query, fetches deck data with optional card counts, and transforms response to include card_count property.
  async listDecks(includeCardCounts = false): Promise<Record<string, unknown>> { const fields: unknown[] = ["id", "title"]; if (includeCardCounts) fields.push({ cards: ["id"] }); const result = await query({ _root: [{ account: [{ decks: fields }] }], }); const decks = this.extractList(result, "decks"); return { decks: decks.map((d) => ({ ...d, card_count: Array.isArray(d.cards) ? (d.cards as unknown[]).length : undefined, })), }; }