trulyform is a form builder. Its MCP server lets an AI assistant work in a person's own trulyform account: create forms, edit their questions, logic and design, publish them, and read the responses.
What you need to know
- Server:
https://trulyform.com/mcp, remote MCP over HTTP. Setup steps are in Connect. - Sign-in: the person signs in to trulyform in a browser and approves access. There are no API keys.
- A form is one JSON document, the form definition. Read it with
get_form, edit it, and save the whole document withsave_form_draft. - Saving never publishes. Publishing is a separate call, made only when the person asks for it.
- Start with Build a form, step by step. Look up details in Question types and Limits and errors.
The tools
The server offers 10 tools.
| Tool | What it does |
|---|---|
read_docs |
Read trulyform’s docs for building forms, as Markdown. |
list_forms |
List forms in your organization, newest IDs first. |
get_form |
Read the complete current draft definition, revision, validation issues, and publication information. |
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. |
create_form |
Create an unpublished form in your organization and return its full initial draft. |
save_form_draft |
Replace a form’s entire draft definition and name, preserving draft history. |
publish_form |
Publish the exact reviewed draft revision for new respondents. |
list_responses |
List response IDs, status, version, and timestamps for a form, newest IDs first. |
get_response |
Read one private response with resolved question labels, display answers, active-path indicators, calculations, and file names/sizes. |
form_stats |
Count currently stored completed responses and, when your plan permits partial responses, started responses. |
What a form can contain
- A welcome screen, up to 200 questions shown one at a time, and an ending screen.
- 17 question types, from short text and email to ratings, rankings, matrices and file uploads.
- Logic rules that show, hide, require or skip questions based on earlier answers.
- Calculations that turn answers into numbers, such as a quote or a score.
- Piped answers: an earlier answer or a calculation shown inside a later question or the ending.
- A theme: colors, font, corner radius and spacing.
A form has no pages or sections, exactly one ending, and no redirect after submission.
For agents
- Connected over MCP? Call
read_docsto read any of these pages, or a single section such asquestion-types#file_upload. The pages are also MCP resources attrulyform://docs/{page}. - Every page has a Markdown version at the same address plus
.md, for example https://trulyform.com/docs/question-types.md. - https://trulyform.com/llms.txt lists every page, and https://trulyform.com/llms-full.txt contains all of them in one file.