MCP integration — Generic — Motivation Form

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.

Available tools (summary)

Tool	Description
`create_form`	Create a new form
`update_form`	Patch an existing form's config
`add_field`	Append a field
`deploy_form`	Make the form live
`get_form`	Fetch config and stats
`list_forms`	List all forms
`list_submissions`	Paginated submissions with optional date filter
`get_submission`	Single submission by ID
`get_form_stats`	Views, submissions, completion rate
`get_submission_report`	Structured Markdown report
`export_submissions`	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