Ferramentas MCP

O que você precisa saber

• As ferramentas somente leitura podem ser chamadas a qualquer momento, sem risco.
• create_form cria um formulário novo a cada chamada. Se o retorno se perder, procure o formulário com list_forms antes de tentar de novo.
• save_form_draft e publish_form alteram dados salvos, mas repetir uma chamada idêntica não muda mais nada.
• Todas as ferramentas atuam na organização do usuário conectado. Os IDs de formulário vêm de list_forms ou de create_form.
• Quando uma chamada falha, a ferramenta retorna um erro com code e message. Os códigos estão em Limites e erros.
• As listas retornam uma página de resultados e um next_cursor. Envie esse valor como cursor para buscar a próxima página; na última, ele vem null.

Ferramentas

A referência técnica a seguir é gerada a partir do código e está em inglês, como os assistentes de IA a leem.

read_docs

Read trulyform’s docs for building forms, as Markdown. Call without a page for the list of pages; start with building-a-form. A page may name one section, such as question-types#file_upload.

Somente leitura.

list_forms

List forms in your organization, newest IDs first. Returns draft revisions and publication status. Follow next_cursor to retrieve another page.

Somente leitura.

get_form

Read the complete current draft definition, revision, validation issues, and publication information. Read this before save_form_draft; a saved draft may differ from the published version.

Somente leitura.

list_field_types

List every question kind with its settings, logic operators, answer shape and a ready-to-edit template, plus the rich-text shape and definition limits. Pass id_count to get fresh UUIDv7 identifiers for new questions, choices, rows, rules and calculations.

Somente leitura.

create_form

Create an unpublished form in your organization and return its full initial draft. Optionally provide its name, then edit with save_form_draft. Each call creates a new form: inspect list_forms before retrying if a reply is lost.

Cria dados novos. Não repita a chamada sem conferir antes.

save_form_draft

Replace a form’s entire draft definition and name, preserving draft history. Read get_form first and use its draft_revision as base_revision. Send a new UUIDv7 mutation_id per edit; retries must reuse the exact same payload and ID. Existing publication stays unchanged. Re-read and reconcile on draft_conflict. read_docs explains the definition format and every error.

Altera dados salvos. Repetir a mesma chamada não muda o resultado.

publish_form

Publish the exact reviewed draft revision for new respondents. Only call when the user requests publication. Rejects stale revisions and invalid drafts; previously saved responses keep their original version. Republishing identical content creates no duplicate version. A closed form stays closed.

Altera dados salvos. Repetir a mesma chamada não muda o resultado.

list_responses

List response IDs, status, version, and timestamps for a form, newest IDs first. Use get_response for answers. Partial responses require the organization’s existing plan entitlement; otherwise only completed responses are returned. Follow next_cursor for another page.

Somente leitura.

get_response

Read one private response with resolved question labels, display answers, active-path indicators, calculations, and file names/sizes. Uses the response’s original published version. Only retrieve answers needed for the user’s request. Partial responses require the existing plan entitlement. No respondent credentials, metadata, or download links are returned.

Somente leitura.

form_stats

Count currently stored completed responses and, when your plan permits partial responses, started responses. Started means an existing incomplete response, not a page visit. Deleted responses are excluded. These are response counts, not unique visitors, billing usage, or conversion analytics.

Somente leitura.