Mailchimp MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:926-935 (handler)

  The handler logic within handleToolCall for the "get_folder" tool. It calls the MailchimpService.getFolder method with the provided folder_id and returns the folder details as a JSON-formatted text response.

  case "get_folder":
    const folder = await service.getFolder(args.folder_id);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(folder, null, 2),
        },
      ],
    };

• src/tools/index.ts:331-344 (registration)

  Registration of the "get_folder" tool in the getToolDefinitions function, including name, description, and input schema.

  {
    name: "get_folder",
    description: "Get details of a specific folder",
    inputSchema: {
      type: "object",
      properties: {
        folder_id: {
          type: "string",
          description: "The folder ID",
        },
      },
      required: ["folder_id"],
    },
  },

• src/tools/index.ts:334-343 (schema)

  Input schema definition for the "get_folder" tool, specifying folder_id as a required string parameter.

  inputSchema: {
    type: "object",
    properties: {
      folder_id: {
        type: "string",
        description: "The folder ID",
      },
    },
    required: ["folder_id"],
  },

• src/services/mailchimp.ts:265-267 (helper)

  The MailchimpService helper method that performs the actual API call to retrieve folder details using the Mailchimp API endpoint /campaign-folders/{folderId}.

  async getFolder(folderId: string): Promise<MailchimpFolder> {
    return await this.makeRequest(`/campaign-folders/${folderId}`);
  }