MCP integration — Generic — Motivation Form

Motivation Form lets AI agents create forms, surveys, and quizzes from prompts or API calls, then deploy them as live public pages.

Connect it to Claude Code, Cursor, or Codex and launch your first form from a conversation.

This guide covers the Motivation Form MCP server protocol for any MCP-compatible client — Cursor, Windsurf, or a custom agent you build yourself.

Server endpoint

POST https://app.form.gold/api/mcp

The server speaks MCP over HTTP using JSON-RPC 2.0.

Authentication

Pass your API key as a Bearer token in every request:

Authorization: Bearer YOUR_API_KEY

Get an API key from your account settings.

Client configuration

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

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

Windsurf / Codeium

Add to your Windsurf agent config:

{
  "mcp_servers": [
    {
      "name": "motivation-form",
      "url": "https://app.form.gold/api/mcp",
      "auth": {
        "type": "bearer",
        "token": "YOUR_API_KEY"
      }
    }
  ]
}

Custom client

Send a JSON-RPC request to the MCP endpoint:

curl -X POST https://app.form.gold/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_forms",
      "arguments": {}
    }
  }'

Tool schema discovery

List all available tools:

curl -X POST https://app.form.gold/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

MCP discovery

The server publishes a discovery document at:

GET https://app.form.gold/.well-known/mcp.json

MCP-aware clients can auto-discover the server URL and available tools from this endpoint.

Official MCP Registry name:

io.github.motivation-labs/motivation-form

Available tools (summary)

Tool	Description
`create_form`	Create a new form
`update_form`	Patch an existing form's config
`update_form_access`	Set or rotate respondent access policy
`add_field`	Append a field
`deploy_form`	Make the form live
`review_form`	Lint raw Markdown or an owned form without changing it
`get_form`	Fetch config and stats
`list_forms`	List all forms
`list_responses`	Paginated responses with optional date filter
`get_response`	Single response by ID
`get_form_stats`	Views, responses, completion rate
`get_response_report`	Structured Markdown report
`export_responses`	CSV, JSON, or Markdown export

Review a form before deploy

Call review_form with exactly one source:

md_content: a complete draft .md string with YAML frontmatter.
form_slug: an existing form owned by the authenticated account.

The tool returns deterministic findings with severity, optional field_id, issue, and suggestion, plus error/warning/info counts. It is read-only and makes no external model calls. Fix errors and warnings before deploy; treat informational findings as prompts that may depend on the form's purpose.

OpenAPI spec

The REST API is fully documented at:

GET https://app.form.gold/api/openapi.json

MCP integration — Generic

On this page