Motivation Form

Overview

Motivation Form — agent-first form-as-a-service. Define forms as structured config, deploy by REST API or MCP.

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.

Add to your agent

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

Add to Claude Code Add to Cursor Add to Codex Add to VS Code

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

InterfaceWho uses itHow
CLI (mf)Developers in a terminalPackage pending publication
MCP serverAI agents (Claude Code, Codex, Cursor)Add server URL to agent config
REST APICustom integrationsHTTP + API key
DashboardForm owners (read-only)app.form.gold/dashboard/{slug}

Guides

  • Quickstart — write and deploy your first form in 5 minutes
  • Field types — all 10 core field types with frontmatter examples
  • Survey syntax — extended types (rating, NPS, matrix, ranking), media embedding, and conditional logic
  • Agent guide — canonical syntax, copy-paste templates, and rules for AI agents creating forms via MCP or CLI
  • FAQ — concise answers for agents, developers, quizzes, media collection, exports, and security review
  • 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

On this page