Mailchimp MCP Server

Instructions

Implementation Reference

• src/services/mailchimp.ts:344-352 (handler)

  Core handler implementing the tool logic: fetches conversations from Mailchimp API using paginated request to /conversations endpoint.

  async listConversations(): Promise<{
    conversations: MailchimpConversation[];
  }> {
    return await this.makePaginatedRequest(
      "/conversations",
      "timestamp",
      "DESC"
    );
  }

• src/tools/index.ts:517-525 (registration)

  Tool registration in getToolDefinitions: defines name, description, and empty input schema for MCP tool listing.

  {
    name: "list_conversations",
    description: "List all conversations",
    inputSchema: {
      type: "object",
      properties: {},
      required: [],
    },
  },

• src/tools/index.ts:1135-1153 (handler)

  Dispatcher handler in handleToolCall: calls service.listConversations() and returns formatted JSON summary of conversations.

  case "list_conversations":
    const conversations = await service.listConversations();
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            conversations.conversations.map((c) => ({
              id: c.id,
              subject: c.subject,
              from_email: c.from_email,
              timestamp: c.timestamp,
            })),
            null,
            2
          ),
        },
      ],
    };

• src/types/index.ts:911-928 (schema)

  Type definition for MailchimpConversation used in the output type of listConversations().

  export interface MailchimpConversation {
    id: string;
    message_id: string;
    list_id: string;
    from_email: string;
    from_label: string;
    subject: string;
    message: string;
    read: boolean;
    timestamp: string;
    _links?: Array<{
      rel: string;
      href: string;
      method: string;
      targetSchema?: string;
      schema?: string;
    }>;
  }