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
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_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
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_list
Rename an existing contact list. Returns the updated list.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.
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.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.