Overview

Motivation Form is an agent-first form-as-a-service product by Motivation Labs. Forms are defined as structured config, deployed via REST API or MCP agent, and rendered as branded public pages at form.gold/[handler]/[slug]. Responses are stored in Supabase and delivered by email.

Use a hosted questionnaire when an agent needs structured, asynchronous input that should outlive the current chat: several people answering the same questions, comparable ratings or rankings, or a scored knowledge check. The agent can draft, publish, retrieve, and synthesize the responses, then update PRDs, Linear issues, plans, or code with the evidence.

Add to your agent

One-line installs for every client (get an API key at your dashboard first):

Claude Code (or use the plugin for the MCP server + agent Skill in one step):

export MOTIVATION_FORM_API_KEY="mf_sk_…"
claude mcp add --transport http --scope user motivation-form \
  https://app.form.gold/api/mcp \
  --header "Authorization: Bearer $MOTIVATION_FORM_API_KEY"

How it works

A form is a structured config. You deploy it with one REST call or one MCP tool call — it becomes a live, branded public page. Respondents fill and submit the form; you receive responses by email and view them in the dashboard.

curl https://app.form.gold/api/forms \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @my-form.json
# returns https://form.gold/acme/my-form

Or from an agent conversation:

> Deploy the campaign-brief form and give me the URL.
[MCP: deploy_form("campaign-brief")]
→ https://form.gold/acme/campaign-brief

Primary interfaces

Guides

• Quickstart — write and deploy your first form in 5 minutes
• Agent feedback workflow — decide when to use a form instead of chat, then turn responses into product and engineering updates
• Field types — all 10 core field types with frontmatter examples
• Survey syntax — extended types (rating, NPS, matrix, ranking), media embedding, and conditional logic
• Survey design checklist — research-backed question writing, ordering, pretesting, and synthesis guidance
• Quiz design checklist — objectives, multiple-choice construction, scoring, and feedback guidance
• Examples — valid sample surveys and quizzes for agent workflows and demos
• Agent guide — canonical syntax, copy-paste templates, and rules for AI agents creating forms via MCP or CLI
• MCP — Claude Code — add Motivation Form to Claude Code
• MCP — Codex — use Motivation Form from OpenAI Codex
• MCP — Generic — MCP protocol reference for any client
• CLI reference — all mf commands and flags
• API reference — REST endpoints, auth, request/response shapes
• Response reports — Markdown report format, feeding reports to agents
• Data export — CSV and JSON export, date filtering, jq examples
• Notifications — email subjects, .md attachment format
• Branding — logo, colors, multi-step layout
• Trust and security — security, privacy, and compliance review details
• Self-hosting — run on your own Vercel + Supabase project