Mailchimp MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:1155-1164 (handler)

  The MCP tool handler for 'get_conversation'. It calls the MailchimpService.getConversation method with the provided conversation_id and formats the response as MCP tool content with JSON stringified data.

  case "get_conversation":
    const conversation = await service.getConversation(args.conversation_id);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(conversation, null, 2),
        },
      ],
    };

• src/tools/index.ts:527-539 (schema)

  Input schema definition for the 'get_conversation' tool, specifying an object with required 'conversation_id' string property.

    name: "get_conversation",
    description: "Get details of a specific conversation",
    inputSchema: {
      type: "object",
      properties: {
        conversation_id: {
          type: "string",
          description: "The conversation ID",
        },
      },
      required: ["conversation_id"],
    },
  },

• src/index.ts:42-46 (registration)

  MCP server registration for listing tools, which includes the 'get_conversation' tool via getToolDefinitions.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: getToolDefinitions(mailchimpService),
    };
  });

• src/services/mailchimp.ts:354-358 (helper)

  MailchimpService helper method that performs the API GET request to retrieve conversation details by ID.

  async getConversation(
    conversationId: string
  ): Promise<MailchimpConversation> {
    return await this.makeRequest(`/conversations/${conversationId}`);
  }

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

  TypeScript interface defining the structure of a Mailchimp conversation (output type for the tool).

  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;
    }>;
  }