bulk_create_from_csv

Instructions

Implementation Reference

• packages/mcp/src/tools.ts:824-841 (handler)

  The handler function for the bulk_create_from_csv tool. Sends CSV content to the /api/qr/bulk/csv endpoint via POST.

  bulk_create_from_csv: {
    description:
      "Create up to 500 QR codes from CSV data. Pro plan required. Send the CSV content as a string. " +
      "Required column: target_url. Optional columns: label, format, type, foreground_color, background_color, " +
      "dot_style, corner_style, frame_style, frame_text, expires_at. Returns all created QR codes.",
    inputSchema: z.object({
      csv_content: z
        .string()
        .describe(
          'CSV content as a string with header row. Example: "target_url,label\\nhttps://example.com,My QR\\nhttps://other.com,Other QR"'
        ),
    }),
    handler: async (input: { csv_content: string }) => {
      return apiRequest("/api/qr/bulk/csv", {
        method: "POST",
        body: { csv_content: input.csv_content },
      });
    },

• packages/mcp/src/server.ts:21-54 (registration)

  Registration loop that iterates over all exported tools (including bulk_create_from_csv) and registers them with the MCP server.

  for (const [name, tool] of Object.entries(tools)) {
    server.tool(
      name,
      tool.description,
      tool.inputSchema.shape,
      async (input: Record<string, unknown>) => {
        try {
          const result = await tool.handler(input as any);
          return {
            content: [
              {
                type: "text" as const,
                text: JSON.stringify(result, null, 2),
              },
            ],
          };
        } catch (error) {
          const message = error instanceof Error ? error.message : String(error);
          return {
            content: [
              {
                type: "text" as const,
                text: JSON.stringify({
                  error: message,
                  hint: "Check the input parameters and try again. Use list_qr_codes to verify available QR codes.",
                }),
              },
            ],
            isError: true,
          };
        }
      }
    );
  }

• packages/mcp/src/api-client.ts:13-40 (helper)

  Helper function apiRequest that makes HTTP API calls. Used by the bulk_create_from_csv handler to POST to /api/qr/bulk/csv.

  export async function apiRequest(path: string, options: RequestOptions = {}) {
    const { method = "GET", body, query } = options;
  
    let url = `${BASE_URL}${path}`;
    if (query) {
      const params = new URLSearchParams();
      for (const [key, value] of Object.entries(query)) {
        params.set(key, String(value));
      }
      url += `?${params.toString()}`;
    }
  
    const headers: Record<string, string> = {
      "X-API-Key": API_KEY,
    };
  
    if (body) {
      headers["Content-Type"] = "application/json";
    }
  
    const res = await fetch(url, {
      method,
      headers,
      body: body ? JSON.stringify(body) : undefined,
    });
  
    return res.json();
  }