Klaviyo MCP Server

Implementation Reference

• src/tools/forms.js:35-46 (handler)

  The handler function for the 'get_form' tool. It fetches the specific form from the Klaviyo API using the provided form ID and returns the JSON-stringified form data or an error message.

  async (params) => {
    try {
      const form = await klaviyoClient.get(`/forms/${params.id}/`);
      return {
        content: [{ type: "text", text: JSON.stringify(form, null, 2) }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error retrieving form: ${error.message}` }],
        isError: true
      };
    }

• src/tools/forms.js:32-34 (schema)

  The Zod input schema for the 'get_form' tool, requiring a string 'id' parameter for the form ID.

  {
    id: z.string().describe("ID of the form to retrieve")
  },

• src/tools/forms.js:31-49 (registration)

  The registration of the 'get_form' tool within the registerFormTools function, specifying name, input schema, handler, and description.

    "get_form",
    {
      id: z.string().describe("ID of the form to retrieve")
    },
    async (params) => {
      try {
        const form = await klaviyoClient.get(`/forms/${params.id}/`);
        return {
          content: [{ type: "text", text: JSON.stringify(form, null, 2) }]
        };
      } catch (error) {
        return {
          content: [{ type: "text", text: `Error retrieving form: ${error.message}` }],
          isError: true
        };
      }
    },
    { description: "Get a specific form from Klaviyo" }
  );

• src/server.js:46-46 (registration)

  Top-level invocation of registerFormTools(server), which registers the 'get_form' tool along with other form-related tools.

  registerFormTools(server);