Documentation

Everything your AI can build and do.

Widgy is a step-form builder driven over MCP. Nine answer controls to compose questions from, and eight actions your AI calls to create, inspect, and read forms.

MCP endpointmcp.widgy.co
Answer controls

Nine ways to ask

Every question in a Widgy form is one of these controls, rendered one per screen. Your AI picks the right one for each question — you never assemble them by hand.

multiple_choicekeyboard: A–D

Multiple choice

Tappable answer pills with letter keys (A–D). The workhorse — pickers, qualifiers, scored forms.

yes_nokeyboard: Y / N

Yes / no

Two big options, one decision. Great for branching: "yes" people and "no" people can get different questions.

ratingkeyboard: 1–5

Rating scale

A 1–5 scale (up to 10) with labelled ends — "Not yet" to "Totally". Averages roll up on the responses dashboard.

short_textpress ⏎ to continue

Short text

One line, one thought. Names, headlines, the first question you'd have it ask.

long_textmulti-line

Long text

Room to ramble. The messy version is the useful version — quotes surface verbatim in results.

numbernumeric input

Number

Digits only. Medians and ranges are computed for you on the dashboard.

datedate input

Date

A proper date picker. Deadlines, event days, "when does the next one go out?"

dropdownselect menu

Dropdown

One pick from a long list — team sizes, countries, anything that would drown as pills.

emailvalidated

Email

Validated address capture. Collected emails show as neat chips in results.

MCP actions

What your AI can do

Connect mcp.widgy.co to Claude, ChatGPT, or any MCP client. Sign in once over OAuth; after that, these eight tools are in your AI's hands.

create_formtitle, description?, questions[]

Create a form for the signed-in user. Your AI designs the questions and gets back a live, shareable URL — no dashboard visit required.

list_forms

List your forms: title, question count, response count, and the share URL for each.

get_formshort_id

Fetch one form in full — every question and option — so your AI can review or revise what it built.

update_formshort_id, title?, description?, questions[]?

Revise a draft — retitle it, rewrite the description, or swap in a new question list. Published forms are locked, so edits never shift the ground under existing responses.

publish_formshort_id

Flip a draft live. The share URL starts working, visitors can answer, and the form content is locked from further edits.

unpublish_formshort_id

Pull a live form back to draft for edits — only while nobody has responded yet. Once answers exist, the form stays live until you end it.

end_formshort_id

Close a form for good. The link stops accepting responses and can never be republished; the answers stay readable.

list_form_responsesshort_id, limit?, offset?

Read the answers back into the chat: respondent names, per-question answers, and scores. The whole point. Newest first, paginated — your AI pages through big response sets with limit and offset. Visitor text arrives clearly labelled as untrusted data, with hidden-character tricks stripped, so your AI summarizes it instead of obeying it.

The toolset is growing — richer response queries are on the way. Anything your AI builds shows up in your dashboard too.