MCP integration — Generic — Motivation Form Docs

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
`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

OpenAPI spec

The REST API is fully documented at:

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

MCP integration — Generic

On this page