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

# Saved searches

> Saved search CRUD MCP tools.

Create, list, update, and delete saved search configurations.

| Tool                  | Description                                        | Risk          | Schema                                         |
| --------------------- | -------------------------------------------------- | ------------- | ---------------------------------------------- |
| `list_saved_searches` | List all saved searches, or get one by ID.         | `read`        | [#list\_saved\_searches](#list_saved_searches) |
| `create_saved_search` | Save search filter values as a named saved search. | `write`       | [#create\_saved\_search](#create_saved_search) |
| `update_saved_search` | Update name, values, or sort options.              | `write`       | [#update\_saved\_search](#update_saved_search) |
| `delete_saved_search` | Permanently delete a saved search.                 | `destructive` | [#delete\_saved\_search](#delete_saved_search) |

## create\_saved\_search

<ParamField path="type" type="string" required>
  `"contacts"` or `"companies"`.
</ParamField>

<ParamField path="values" type="object" required>
  Filter object (same fields as `search_contacts` or `search_companies`). Not `filters`.
</ParamField>

### Example

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_saved_search",
    "arguments": {
      "name": "VP Sales - SaaS Texas",
      "type": "contacts",
      "values": {
        "jobTitle": ["VP Sales"],
        "contactState": ["Texas"]
      }
    }
  },
  "id": 1
}
```