Skip to main content
Access: All users. See Access control.

get_lists

List all contact lists, or get a specific list by ID. When listId is provided, returns that list with contact count. Otherwise returns a table of all lists. To add saved contacts or companies to one of these lists, pass its listId to update_my_contact or update_my_company.

Arguments

integer | string
ID of a specific list to retrieve. Omit to list all.

Result

Returns a text content block and a structuredContent object with these fields. Treat every field as nullable: a value the record does not have comes back as null.
object[]
Result records when listingFields vary by record.
object
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_list

Create a new contact list. Returns the created list with its ID. Lists organize saved contacts: add contacts that are already saved by passing the new list ID to update_my_contact, or pass it to research_contacts as listIds to file contacts into the list as they are researched. Never leave a new list empty when the user asked for it to be populated.

Arguments

string
required
Name for the new list.

Result

Returns a text content 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_list

Rename an existing contact list. Returns the updated list.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
ID of the list to rename.
string
required
New name for the list.

Result

Returns a text content 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_list

Permanently delete a contact list. This removes the list but does not delete the contacts in it. Use get_lists to find list IDs.
May overwrite, remove, or send data in a way that cannot be undone. Ask for explicit confirmation before calling this tool in an agent workflow.

Arguments

integer | string
required
ID of the list to delete.

Result

Returns a text content 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.