get_conversation
Retrieve specific conversation details from Mailchimp to access email marketing interactions and customer communications.
Instructions
Get details of a specific conversation
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| conversation_id | Yes | The conversation ID |
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; }>; }