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,
      })),
    };
  }