Omnisend MCP Server

Instructions

Implementation Reference

• src/tools/products/index.ts:146-167 (handler)

  The handler function for the 'replaceProduct' MCP tool. It invokes the API replaceProduct helper, filters the response using filterProductFields, formats it as JSON text content, and handles errors by returning error messages.

  async (args) => {
    try {
      const response = await replaceProduct(args.productId, args.productData);
      
      // Filter product data to include only defined fields
      const filteredProduct = filterProductFields(response);
      
      return {
        content: [
          { 
            type: "text", 
            text: JSON.stringify(filteredProduct, null, 2) 
          }
        ]
      };
    } catch (error) {
      if (error instanceof Error) {
        return { content: [{ type: "text", text: `Error: ${error.message}` }] };
      }
      return { content: [{ type: "text", text: "An unknown error occurred" }] };
    }
  }

• src/tools/products/index.ts:132-145 (schema)

  Input schema definition for the 'replaceProduct' tool, specifying parameters productId (string) and productData (object).

  {
    additionalProperties: false,
    properties: {
      productId: { description: "Product ID", type: "string" },
      productData: { 
        additionalProperties: true,
        description: "Product data in the same structure as returned by getProduct", 
        properties: {},
        type: "object" 
      }
    },
    required: ["productId", "productData"],
    type: "object"
  },

• src/tools/products/index.ts:129-168 (registration)

  Registration of the 'replaceProduct' tool on the MCP server using server.tool(), including name, description, schema, and handler.

  server.tool(
    "replaceProduct",
    "Replace an existing product with new data. IMPORTANT: You must first get the product using getProduct and preserve the returned structure when replacing. The replace request requires the same structure as returned by the GET method, with only your desired changes applied.",
    {
      additionalProperties: false,
      properties: {
        productId: { description: "Product ID", type: "string" },
        productData: { 
          additionalProperties: true,
          description: "Product data in the same structure as returned by getProduct", 
          properties: {},
          type: "object" 
        }
      },
      required: ["productId", "productData"],
      type: "object"
    },
    async (args) => {
      try {
        const response = await replaceProduct(args.productId, args.productData);
        
        // Filter product data to include only defined fields
        const filteredProduct = filterProductFields(response);
        
        return {
          content: [
            { 
              type: "text", 
              text: JSON.stringify(filteredProduct, null, 2) 
            }
          ]
        };
      } catch (error) {
        if (error instanceof Error) {
          return { content: [{ type: "text", text: `Error: ${error.message}` }] };
        }
        return { content: [{ type: "text", text: "An unknown error occurred" }] };
      }
    }
  );

• src/api-resources/products/index.ts:47-57 (helper)

  API helper function that performs the HTTP PUT request to the Omnisend API to replace a product by ID.

  export const replaceProduct = async (productId: string, productData: Partial<Product>): Promise<Product> => {
    try {
      const response = await omnisendApi.put<Product>(`/products/${productId}`, productData);
      return response.data;
    } catch (error) {
      if (error instanceof Error) {
        throw new Error(`Error replacing product: ${error.message}`);
      } else {
        throw new Error('Unknown error occurred when replacing product');
      }
    }