list_conversations
Retrieve all email conversations from your Mailchimp account to monitor customer interactions and track communication history.
Instructions
List all conversations
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
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; }>; }