# list_lists (/docs/mcp/tools/list-lists)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/list_lists.mdx. */}

**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 [#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 [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "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"
    ]
  }
}
```