list_saved_searches
List saved searches, or get a specific saved search by ID. When id is provided, returns that saved search with its filter values. Otherwise returns a table of all saved searches.Arguments
Filter by search type (only used when listing). “contacts” or “companies”.One of:
contacts, companies.Result
Returns a textcontent block and a structuredContent object with these fields. Treat every field as nullable: a value the record does not have comes back as null.
Pagination metadata when available. Carries only the values the service has, so treat a missing key as unknown rather than zero; nextCursor is null or absent on the last page.
create_saved_search
Save a set of search filters as a named saved search for later reuse. Returns the created saved search with its ID.Arguments
Search filter values to save (same filters used in search_contacts or search_companies).Fields vary by record.
Number of approved results for this saved search. Defaults to 0 (auto-calculated).
Result
Returns a textcontent block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.
Example
update_saved_search
Update an existing saved search name, filters, or sort options. Returns the updated saved search. When values is provided it replaces the saved filters wholesale rather than merging with the existing filters.Arguments
Replacement search filter values, in the same form list_saved_searches returns them — read the saved search, change what you need, and send the values back. Replaces existing filters wholesale rather than merging. Omit to leave filters unchanged.Fields vary by record.
Result
Returns a textcontent block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.
delete_saved_search
Permanently delete a saved search by its ID. This cannot be undone. Use list_saved_searches to find saved search IDs.Arguments
Result
Returns a textcontent block describing the outcome, plus a structuredContent object that mirrors it. This tool publishes no outputSchema, so the object’s fields are not guaranteed; treat every field as optional and nullable.