MCP integration — Claude Code

Add Motivation Form to Claude Code so agents can create, deploy, and query forms within any conversation.

This guide covers adding Motivation Form as an MCP server in Claude Code. Once configured, Claude Code can create forms, deploy them, read submissions, and generate reports without leaving the conversation.

Prerequisites

Claude Code installed (npm install -g @anthropic-ai/claude-code)
A Motivation Form API key — get one from your account settings

1. Add the MCP server

Open your Claude Code settings file at ~/.claude/settings.json (create it if it doesn't exist) and add the Motivation Form MCP server:

{
  "mcpServers": {
    "motivation-form": {
      "url": "https://app.form.gold/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your actual API key.

2. Verify the connection

Start a new Claude Code session and ask:

What MCP tools do you have available for Motivation Form?

You should see the 11 available tools listed, including create_form, deploy_form, list_submissions, and others.

Example conversations

Create and deploy a form

> Create a contact form with name, email, and message fields. Deploy it and give me the URL.

[Using create_form]
[Using deploy_form]
→ Live at https://app.form.gold/contact

Read recent submissions

> Show me the last 10 submissions for the contact form.

[Using list_submissions({ slug: "contact", limit: 10 })]
→ Returns 10 most recent submissions with timestamps and field values

Generate a submission report

> Generate a weekly report for the campaign-brief form covering the last 7 days.

[Using get_submission_report({ slug: "campaign-brief", period: "7d" })]
→ Returns a structured Markdown report with aggregate stats and per-field distributions

Add a field to an existing form

> Add a "company size" dropdown to the contact form with options: 1–10, 11–50, 51–200, 200+

[Using update_form or add_field]
→ Field added, form redeployed automatically

Available MCP tools

Tool	What it does
`create_form`	Create a new form with title, slug, fields, branding, and notifications
`update_form`	Patch an existing form's config
`add_field`	Append a field to an existing form
`deploy_form`	Make the form live at its public URL
`get_form`	Fetch a form's current config and stats
`list_forms`	List all forms for your account
`list_submissions`	Fetch paginated submissions with optional date filter
`get_submission`	Fetch a single submission by ID
`get_form_stats`	Views, submissions, completion rate, 7-day sparkline
`get_submission_report`	Agent-readable Markdown report (aggregate + granular)
`export_submissions`	Export submissions as CSV, JSON, or Markdown

Tips for agents

Use get_form first to understand a form's current schema before modifying it
get_submission_report returns structured Markdown designed for agent re-processing — pipe it into a chart generation or analysis step
export_submissions with format: "markdown" produces a table that pastes cleanly into a document or message

MCP integration — Claude Code

On this page