> ## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.