get_credits
Get the authenticated user’s remaining credits by credit category, each with when it next refreshes (null if it does not). Balances can be fractional, up to 3 decimal places. The seamless://credits resource provides the same data. When linking to the Seamless web app, use the applicationBaseUrl from seamless://me as the root; never invent hostnames such as app.seamless.ai.Arguments
This tool takes no arguments.Result
Returns a textcontent block and a structuredContent object. Its fields are the record’s own and vary by record; treat every field as nullable.
Example
get_my_contacts
Retrieve previously saved/researched contacts for the authenticated user within a date range (max 30 days). Defaults to the last 30 days if no dates are provided. Returns a paginated table. Use search_contacts to find new contacts in the Seamless.AI database.Arguments
Start date (ISO 8601, e.g. 2025-01-01T00:00:00Z). Defaults to 30 days ago. Max range: 30 days.
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.
Example
update_my_contact
Update saved contacts. Currently manages which lists they belong to: listAction “add” (default) keeps existing lists, “remove” drops only the supplied lists, and “replace” makes the supplied lists their complete set of lists. Contact IDs come from get_my_contacts (or the contactId of an already saved search_contacts result); list IDs from get_lists or create_list. Returns the contacts that changed, plus skippedContactIds for any that did not — check it before reporting success. To file contacts into a list as part of researching them, pass listIds to research_contacts instead.Arguments
IDs of the lists to apply. May be empty only with listAction “replace”, which clears every list off the contacts.Up to 50 items.
How listIds is applied. Defaults to “add”, which leaves the contacts in any lists they are already in.One of:
add, remove, replace.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
get_my_companies
Retrieve previously saved/researched companies for the authenticated user within a date range (max 30 days). Defaults to the last 30 days if no dates are provided. Returns a paginated table. Use search_companies to find new companies in the Seamless.AI database.Arguments
Start date (ISO 8601, e.g. 2025-01-01T00:00:00Z). Defaults to 30 days ago. Max range: 30 days.
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.
Example
update_my_company
Update saved companies. Currently manages which lists they belong to: listAction “add” (default) keeps existing lists, “remove” drops only the supplied lists, and “replace” makes the supplied lists their complete set of lists. Company IDs come from get_my_companies; list IDs from get_lists or create_list. Returns the companies that changed, plus skippedCompanyIds for any that did not — check it before reporting success.Arguments
IDs of the lists to apply. May be empty only with listAction “replace”, which clears every list off the companies.Up to 50 items.
How listIds is applied. Defaults to “add”, which leaves the companies in any lists they are already in.One of:
add, remove, replace.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.