Dumpling AI MCP Server

Instructions

Implementation Reference

• src/index.ts:596-618 (handler)

  The handler function for the 'merge-pdfs' tool. It proxies the request to an external API at NWS_API_BASE/api/v1/merge-pdfs using the provided input parameters, handles authentication with DUMPLING_API_KEY, and returns the JSON response.

  async ({ inputMethod, files, metadata, pdfa, pdfua, requestSource }) => {
    const apiKey = process.env.DUMPLING_API_KEY;
    if (!apiKey) throw new Error("DUMPLING_API_KEY not set");
    const response = await fetch(`${NWS_API_BASE}/api/v1/merge-pdfs`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${apiKey}`,
      },
      body: JSON.stringify({
        inputMethod,
        files,
        metadata,
        pdfa,
        pdfua,
        requestSource,
      }),
    });
    if (!response.ok)
      throw new Error(`Failed: ${response.status} ${await response.text()}`);
    const data = await response.json();
    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
  }

• src/index.ts:577-595 (schema)

  Zod schema defining the input parameters for the 'merge-pdfs' tool: inputMethod (url or base64), files (array of strings), optional metadata object, pdfa compliance option, pdfua boolean, and requestSource.

  {
    inputMethod: z.enum(["url", "base64"]).describe("Input method"),
    files: z.array(z.string()).describe("Array of URLs or base64-encoded PDFs"),
    metadata: z
      .object({
        Title: z.string().optional(),
        Author: z.string().optional(),
        Subject: z.string().optional(),
        Keywords: z.string().optional(),
      })
      .optional()
      .describe("Metadata for merged PDF"),
    pdfa: z
      .enum(["PDF/A-1b", "PDF/A-2b", "PDF/A-3b"])
      .optional()
      .describe("PDF/A compliance"),
    pdfua: z.boolean().optional().describe("PDF/UA compliance"),
    requestSource: z.string().optional().describe("Request source"),
  },

• src/index.ts:574-619 (registration)

  The server.tool call that registers the 'merge-pdfs' tool with its name, description, input schema, and handler function.

  server.tool(
    "merge-pdfs",
    "Combine multiple PDF files into a single document.",
    {
      inputMethod: z.enum(["url", "base64"]).describe("Input method"),
      files: z.array(z.string()).describe("Array of URLs or base64-encoded PDFs"),
      metadata: z
        .object({
          Title: z.string().optional(),
          Author: z.string().optional(),
          Subject: z.string().optional(),
          Keywords: z.string().optional(),
        })
        .optional()
        .describe("Metadata for merged PDF"),
      pdfa: z
        .enum(["PDF/A-1b", "PDF/A-2b", "PDF/A-3b"])
        .optional()
        .describe("PDF/A compliance"),
      pdfua: z.boolean().optional().describe("PDF/UA compliance"),
      requestSource: z.string().optional().describe("Request source"),
    },
    async ({ inputMethod, files, metadata, pdfa, pdfua, requestSource }) => {
      const apiKey = process.env.DUMPLING_API_KEY;
      if (!apiKey) throw new Error("DUMPLING_API_KEY not set");
      const response = await fetch(`${NWS_API_BASE}/api/v1/merge-pdfs`, {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          Authorization: `Bearer ${apiKey}`,
        },
        body: JSON.stringify({
          inputMethod,
          files,
          metadata,
          pdfa,
          pdfua,
          requestSource,
        }),
      });
      if (!response.ok)
        throw new Error(`Failed: ${response.status} ${await response.text()}`);
      const data = await response.json();
      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
    }
  );