Tools

All tools are read-only and idempotent — none of them create, edit, or delete data.

Tool	Description
`list_teams`	Lists the Confetti Teams available to you.
`list_surveys`	Lists a page of Surveys belonging to a Team.
`get_survey`	Gets a Survey with its complete Question configuration.
`list_responses`	Lists a page of Responses for a Survey.
`get_score_distributions`	Gets score distributions for selected Survey Questions.

Typical flow

Call list_teams first to get a teamSlug, then list_surveys to get a surveyId. From there, use get_survey for the full Question configuration, list_responses for individual Responses, or get_score_distributions for aggregate score counts on selected Questions.

For reporting workflows and example prompts, see Reporting.

`list_teams`

No input.

Output field	Type	Description
`teams`	array	Teams you belong to.
`teams[].id`	string	The Team identifier.
`teams[].name`	string	The Team name.
`teams[].slug`	string	The Team slug, used by the other tools.

`list_surveys`

Input	Type	Required	Description
`teamSlug`	string	Yes	Team slug from `list_teams`.
`page`	integer	No	One-based page number. Defaults to `1`.
`limit`	integer	No	Surveys to return, 1–100. Defaults to `10`.

Output field	Type	Description
`surveys`	array	Surveys on the requested page.
`surveys[].id`	string	The Survey identifier.
`surveys[].title`	string	The Survey title.
`surveys[].description`	string \| null	Optional Survey description.
`surveys[].status`	`active` \| `inactive`	Whether the Survey currently accepts Responses.
`surveys[].createdAt` / `updatedAt`	string	ISO 8601 timestamps.
`surveys[].questions`	array	The first Question, when one exists.
`surveys[]._count.responses`	integer	Number of Responses.
`hasNextPage`	boolean	Whether another page is available.

`get_survey`

Input	Type	Required	Description
`teamSlug`	string	Yes	Team slug from `list_teams`.
`surveyId`	string	Yes	Survey ID from `list_surveys`.

Output field	Type	Description
`id`	string	The Survey identifier.
`title`	string	The Survey title.
`description`	string \| null	Optional Survey description.
`status`	`active` \| `inactive`	Whether the Survey currently accepts Responses.
`createdAt` / `updatedAt`	string	ISO 8601 timestamps.
`confirmation`	JSON	Survey confirmation configuration.
`isPublicForPlatform`	boolean \| null	Whether the Survey is public on the platform.
`questions`	array	All Questions, in display order.
`questions[].id`	string	The Question identifier.
`questions[].title`	string	The Question title.
`questions[].description`	string \| null	Optional Question description.
`questions[].surveyId`	string	The parent Survey identifier.
`questions[].position`	integer \| null	Question display position.
`questions[].required`	boolean	Whether the Question requires an answer.
`questions[].routingLogic`	JSON	The Question's routing logic.
`questions[].properties`	JSON	Question-type-specific configuration.

Unlike list_surveys, this does not include a _count.responses field.

`list_responses`

Input	Type	Required	Description
`teamSlug`	string	Yes	Team slug from `list_teams`.
`surveyId`	string	Yes	Survey ID from `list_surveys`.
`cursor`	string	No	Opaque cursor from a previous call's `nextCursor`.
`limit`	integer	No	Responses to return, 1–100. Defaults to `10`.

Output field	Type	Description
`responses`	array	Responses, newest first.
`responses[].id`	string	The Response identifier.
`responses[].respondent`	string	The caller-supplied respondent identifier.
`responses[].data`	JSON	Answers, keyed by Question identifier.
`responses[].clientMetadata`	JSON	Metadata supplied by the client that recorded it.
`responses[].createdAt`	string	ISO 8601 timestamp.
`nextCursor`	string, optional	Cursor for the next page; omitted on the last page.

`get_score_distributions`

Only meaningful for Questions with a numeric score (e.g. rating Questions). A questionId with no matching Question returns an empty distribution for it rather than an error. An unknown Survey ID, or one from a different Team, returns a Not Found error.

Input	Type	Required	Description
`teamSlug`	string	Yes	Team slug from `list_teams`.
`surveyId`	string	Yes	Survey ID from `list_surveys`.
`questionIds`	string[]	Yes	1–50 unique Question identifiers from `get_survey`.
`timeRange`	string	No	`all-time` (default), `last-7-days`, `last-30-days`, `q<1-4>-<year>` (within the current or previous 4 quarters, e.g. `q1-2026`), or `custom_<start>_<end>` (e.g. `custom_2026-01-01_2026-01-31`).

Output field	Type	Description
`distributions`	array	One entry per requested Question, in requested order.
`distributions[].questionId`	string	The Question identifier.
`distributions[].current`	array of `{score, count}`	Score counts for the requested time window.
`distributions[].previousQuarter`	array of `{score, count}` \| null	Score counts for the previous quarter; `null` for non-quarter ranges.

Typical flow

list_teams

list_surveys

get_survey

list_responses

get_score_distributions

On this page

`list_teams`

`list_surveys`

`get_survey`

`list_responses`

`get_score_distributions`