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

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 text content 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

string
Start date (ISO 8601, e.g. 2025-01-01T00:00:00Z). Defaults to 30 days ago. Max range: 30 days.
string
End date (ISO 8601, e.g. 2025-01-31T23:59:59Z). Defaults to now. Max range: 30 days.
string
Opaque token from pagination.nextCursor
integer
Page size (default 500). Must match the first page’s when cursor is set
string
Comma-separated org IDs to filter by.

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[]
required
Result records for the current page
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.

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.
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
IDs of the saved contacts to update.Up to 500 items.
(integer | string)[]
required
IDs of the lists to apply. May be empty only with listAction “replace”, which clears every list off the contacts.Up to 50 items.
string
default:"add"
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 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

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

string
Start date (ISO 8601, e.g. 2025-01-01T00:00:00Z). Defaults to 30 days ago. Max range: 30 days.
string
End date (ISO 8601, e.g. 2025-01-31T23:59:59Z). Defaults to now. Max range: 30 days.
string
Opaque token from pagination.nextCursor
integer
Page size (default 500). Must match the first page’s when cursor is set
string
Comma-separated org IDs to filter by.

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[]
required
Result records for the current page
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.

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.
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
IDs of the saved companies to update.Up to 500 items.
(integer | string)[]
required
IDs of the lists to apply. May be empty only with listAction “replace”, which clears every list off the companies.Up to 50 items.
string
default:"add"
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 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