get_list
Retrieve detailed information about a specific Mailchimp email list using its unique list ID for email marketing management.
Instructions
Get details of a specific list
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | The list ID |
Implementation Reference
- src/services/mailchimp.ts:159-161 (handler)Core handler function in MailchimpService that fetches the specific list details from the Mailchimp API using the makeRequest method.async getList(listId: string): Promise<MailchimpList> { return await this.makeRequest(`/lists/${listId}`); }
- src/tools/index.ts:105-118 (schema)Tool registration definition including name, description, and input schema for 'get_list' requiring 'list_id'.{ name: "get_list", description: "Get details of a specific list", inputSchema: { type: "object", properties: { list_id: { type: "string", description: "The list ID", }, }, required: ["list_id"], }, },
- src/tools/index.ts:671-680 (registration)Dispatching logic in handleToolCall that handles 'get_list' tool calls by invoking service.getList and formatting the response.case "get_list": const list = await service.getList(args.list_id); return { content: [ { type: "text", text: JSON.stringify(list, null, 2), }, ], };
- src/types/index.ts:329-387 (schema)TypeScript interface defining the output structure MailchimpList returned by the get_list tool.export interface MailchimpList { id: string; name: string; contact: { company: string; address1: string; address2: string; city: string; state: string; zip: string; country: string; phone: string; }; permission_reminder: string; use_archive_bar: boolean; campaign_defaults: { from_name: string; from_email: string; subject: string; language: string; }; notify_on_subscribe: string; notify_on_unsubscribe: string; date_created: string; list_rating: number; email_type_option: boolean; subscribe_url_short: string; subscribe_url_long: string; beamer_address: string; visibility: string; double_optin: boolean; marketing_permissions: boolean; modules: string[]; stats: { member_count: number; unsubscribe_count: number; cleaned_count: number; member_count_since_send: number; unsubscribe_count_since_send: number; cleaned_count_since_send: number; campaign_count: number; campaign_last_sent: string; merge_field_count: number; avg_sub_rate: number; avg_unsub_rate: number; target_sub_rate: number; open_rate: number; click_rate: number; last_sub_date: string; last_unsub_date: string; }; _links?: Array<{ rel: string; href: string; method: string; targetSchema?: string; schema?: string; }>; }