get_lists
Retrieve contact lists from your Apollo account to access saved prospect collections for sales outreach and management.
Instructions
Get all contact lists in your Apollo account. Lists are collections of saved contacts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number |
Implementation Reference
- src/index.ts:939-962 (handler)The handler function that executes the 'get_lists' tool. It makes an API call to Apollo's /contact_lists endpoint, formats the list of contact lists with their names, IDs, contact counts, and creation dates, and returns a formatted text response.private async getLists(args: any) { const response = await this.axiosInstance.get("/contact_lists", { params: args, }); const lists = response.data.contact_lists || []; let result = `Contact Lists (${lists.length}):\n\n`; lists.forEach((list: any, index: number) => { result += `${index + 1}. ${list.name}\n`; result += ` ID: ${list.id}\n`; result += ` Contacts: ${list.num_contacts || 0}\n`; result += ` Created: ${list.created_at ? new Date(list.created_at).toLocaleDateString() : "N/A"}\n\n`; }); return { content: [ { type: "text", text: result, }, ], }; }
- src/index.ts:390-403 (registration)The tool registration entry in the getTools() method, which defines the tool name, description, and input schema for the MCP ListTools request.{ name: "get_lists", description: "Get all contact lists in your Apollo account. Lists are collections of saved contacts.", inputSchema: { type: "object", properties: { page: { type: "number", description: "Page number", }, }, }, },
- src/index.ts:82-83 (registration)The dispatch case in the CallToolRequest handler's switch statement that routes calls to the getLists handler function.case "get_lists": return await this.getLists(args);
- src/index.ts:394-402 (schema)The input schema definition for the 'get_lists' tool, specifying optional pagination.inputSchema: { type: "object", properties: { page: { type: "number", description: "Page number", }, }, },