> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Lists

> Contact list CRUD MCP tools.

Manage contact lists for organizing saved contacts.

| Tool          | Description                                   | Risk          | Schema                        |
| ------------- | --------------------------------------------- | ------------- | ----------------------------- |
| `get_lists`   | List all contact lists, or get one by ID.     | `read`        | [#get\_lists](#get_lists)     |
| `create_list` | Create a new contact list.                    | `write`       | [#create\_list](#create_list) |
| `update_list` | Rename an existing list.                      | `write`       | [#update\_list](#update_list) |
| `delete_list` | Permanently delete a list (not the contacts). | `destructive` | [#delete\_list](#delete_list) |

## create\_list

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_list",
    "arguments": {
      "name": "Q2 prospects"
    }
  },
  "id": 1
}
```

## delete\_list

<Warning>
  Permanent deletion. Requires explicit approval in agent workflows.
</Warning>