MCP server
list_lists
Lists the contact or company lists of one website with their names and ids.
List lists · Read-only
Lists the contact or company lists of one website with their names and ids. Free. Use it to find the listId for get_list, delete_list, remove_list_items or export_list_csv.
| Connection | Account URL, team member URL or OAuth |
|---|
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
websiteId | string | Yes | Website ID from list_websites. |
listType | "contact" | "company" | Yes | contact for lists of people, company for lists of companies. |
page | number | No | Page number, starting at 1. |
limit | number | No | Lists per page. |
Tool definition
What your assistant receives from tools/list:
{
"name": "list_lists",
"title": "List lists",
"annotations": {
"title": "List lists",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"inputSchema": {
"type": "object",
"properties": {
"websiteId": {
"type": "string",
"description": "Website ID from list_websites."
},
"listType": {
"type": "string",
"enum": [
"contact",
"company"
],
"description": "contact for lists of people, company for lists of companies."
},
"page": {
"type": "number",
"minimum": 1,
"description": "Page number, starting at 1."
},
"limit": {
"type": "number",
"minimum": 1,
"description": "Lists per page."
}
},
"required": [
"websiteId",
"listType"
]
}
}