Available Tools Reference¶
!!! info "TL;DR" The MCP server exposes 18 tools across surveys, questions, triggers, responses, and PMF analytics. Each tool requires a specific scope. See the table below for the full list; for request and response parameter details, see the MCP integration guide's tool reference.
Tool List¶
| Tool | Description | Required Scope |
|---|---|---|
survey_create | Create a new survey | surveys:write |
survey_update | Update a survey's title, description, settings | surveys:write |
survey_publish | Publish a survey so it accepts responses | surveys:write |
survey_pause | Pause a published survey | surveys:write |
survey_archive | Archive a survey (irreversible) | surveys:write |
survey_list | List surveys, or fetch one by ID | surveys:read |
pmf_create | Create and publish a complete PMF survey | surveys:write |
question_create | Add a new question to a survey | surveys:write |
question_update | Update a question's text, type, or config | surveys:write |
question_delete | Delete a question from a survey | surveys:write |
questions_reorder | Reorder a survey's questions | surveys:write |
response_list | List responses for a survey | surveys:read |
get_pmf_score | Get the PMF score for a survey | pmf:read |
pmf_segments_list | Get the per-cohort PMF segment breakdown | pmf:read |
trigger_create | Create a trigger that shows a survey | surveys:write |
trigger_update | Update a trigger's config or enabled state | surveys:write |
trigger_list | List all triggers for a survey | surveys:read |
trigger_delete | Delete a trigger | surveys:write |
Survey Management¶
survey_create¶
Creates a new survey.
Required scope: surveys:write
survey_update¶
Updates a survey's title, description, or settings. Does not change survey status; use survey_publish, survey_pause, or survey_archive for status transitions.
Required scope: surveys:write
survey_publish¶
Publishes a survey so it is live and accepting responses.
Required scope: surveys:write
survey_pause¶
Pauses a published survey so it stops accepting responses. Existing responses are preserved and the survey can be published again later.
Required scope: surveys:write
survey_archive¶
Archives a survey. Archiving is irreversible; an archived survey cannot be moved to any other status.
Required scope: surveys:write
survey_list¶
Lists surveys for the organization, or fetches a single survey by ID.
Required scope: surveys:read
PMF Quickstart¶
pmf_create¶
Creates and publishes a complete PMF survey (the four standard PMF questions) for the organization in a single call. Replaces the multi-step sequence of calling survey_create, then question_create four times, then survey_publish.
Required scope: surveys:write
Question Management¶
question_create¶
Adds a new question to an existing survey.
Required scope: surveys:write
question_update¶
Updates a question's text, type, and/or config. Does not accept sort_order; use questions_reorder to change a question's position.
Required scope: surveys:write
question_delete¶
Deletes a question from a survey. Rejects the request if the question is the last one remaining on a published or paused survey.
Required scope: surveys:write
questions_reorder¶
Reorders a survey's questions by providing the full list of question IDs in the desired order.
Required scope: surveys:write
Response Access¶
response_list¶
Lists responses for a survey owned by the organization, most recent first.
Required scope: surveys:read
PMF Analytics¶
get_pmf_score¶
Returns the PMF score (the percentage of respondents who answered "very disappointed") for a survey. Returns a below-threshold state instead of a score when fewer than 30 enriched responses exist.
Required scope: pmf:read
pmf_segments_list¶
Returns the per-cohort PMF segment breakdown for a survey: very_disappointed, somewhat_disappointed, and not_disappointed, each with a count and a percentage.
Required scope: pmf:read
Distribution¶
trigger_create¶
Creates a trigger that determines when a survey is shown to users.
Required scope: surveys:write
trigger_update¶
Updates a trigger's config and/or enabled state.
Required scope: surveys:write
trigger_list¶
Lists all triggers for a survey owned by the organization.
Required scope: surveys:read
trigger_delete¶
Deletes a trigger owned by the organization.
Required scope: surveys:write
What's Next¶
- Agent Authentication: API keys and permission scopes.
- Rate Limits: request quotas per tool.