Mailchimp MCP Server

Instructions

Implementation Reference

• src/services/mailchimp.ts:319-326 (handler)

  Core handler function in MailchimpService that fetches the specific product details via the Mailchimp API endpoint.

  async getProduct(
    storeId: string,
    productId: string
  ): Promise<MailchimpProduct> {
    return await this.makeRequest(
      `/ecommerce/stores/${storeId}/products/${productId}`
    );
  }

• src/tools/index.ts:1091-1100 (handler)

  Tool dispatcher handler case that calls the service method and formats the response as MCP content.

  case "get_product":
    const product = await service.getProduct(args.store_id, args.product_id);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(product, null, 2),
        },
      ],
    };

• src/tools/index.ts:465-482 (registration)

  Tool registration definition including name, description, and input schema for get_product.

  {
    name: "get_product",
    description: "Get details of a specific product",
    inputSchema: {
      type: "object",
      properties: {
        store_id: {
          type: "string",
          description: "The store ID",
        },
        product_id: {
          type: "string",
          description: "The product ID",
        },
      },
      required: ["store_id", "product_id"],
    },
  },

• src/types/index.ts:802-830 (schema)

  TypeScript interface defining the structure of the Mailchimp product response (output schema).

  export interface MailchimpProduct {
    id: string;
    title: string;
    handle: string;
    url: string;
    description: string;
    type: string;
    vendor: string;
    image_url?: string;
    variants: Array<{
      id: string;
      title: string;
      url: string;
      sku: string;
      price: number;
      inventory_quantity: number;
      image_url?: string;
      backorders: string;
      visibility: string;
    }>;
    published_at_foreign?: string;
    _links?: Array<{
      rel: string;
      href: string;
      method: string;
      targetSchema?: string;
      schema?: string;
    }>;
  }