MCP integration — Agent clients

Install Motivation Form in Claude Code, Codex, OpenClaw, Hermes, Pi Agent, opencode, and other MCP-compatible agents.

Motivation Form exposes one remote MCP server for every agent:

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

Use a bearer token from your dashboard:

export MOTIVATION_FORM_API_KEY="mf_live_..."

If a client does not expand environment variables inside JSON/YAML config files, replace ${MOTIVATION_FORM_API_KEY} with the literal key value.

Machine-readable setup data is available at:

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

Claude Code

claude mcp add --transport http --scope user motivation-form \
  https://app.form.gold/api/mcp \
  --header "Authorization: Bearer $MOTIVATION_FORM_API_KEY"

Verify with:

claude mcp list

Codex

codex mcp add motivation-form \
  --url https://app.form.gold/api/mcp \
  --bearer-token-env-var MOTIVATION_FORM_API_KEY

This writes:

[mcp_servers.motivation-form]
url = "https://app.form.gold/api/mcp"
bearer_token_env_var = "MOTIVATION_FORM_API_KEY"

OpenClaw

Current OpenClaw builds vary between the dedicated MCP helper and the generic config helper. Prefer the MCP helper when present:

openclaw mcp set motivation-form '{
  "url": "https://app.form.gold/api/mcp",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer ${MOTIVATION_FORM_API_KEY}"
  }
}'

If the MCP helper is not available in your OpenClaw build:

openclaw config set --json mcp.servers.motivation-form '{
  "url": "https://app.form.gold/api/mcp",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer ${MOTIVATION_FORM_API_KEY}"
  }
}'

Hermes

Add Motivation Form as an HTTP MCP server in your Hermes agent config:

mcp_servers:
  motivation-form:
    url: "https://app.form.gold/api/mcp"
    headers:
      Authorization: "Bearer ${MOTIVATION_FORM_API_KEY}"
    tools:
      include:
        - create_form
        - deploy_form
        - update_form
        - add_field
        - get_form
        - list_forms
        - list_responses
        - get_response
        - get_form_stats
        - get_response_report
        - export_responses

Pi Agent

Pi agents can load a standard .mcp.json file:

{
  "mcpServers": {
    "motivation-form": {
      "type": "http",
      "url": "https://app.form.gold/api/mcp",
      "headers": {
        "Authorization": "Bearer ${MOTIVATION_FORM_API_KEY}"
      },
      "lifecycle": "lazy",
      "directTools": [
        "create_form",
        "deploy_form",
        "list_forms",
        "get_response_report",
        "export_responses"
      ]
    }
  }
}

opencode

Add this to opencode.json or the project-level opencode config:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "motivation-form": {
      "type": "remote",
      "url": "https://app.form.gold/api/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer ${MOTIVATION_FORM_API_KEY}"
      }
    }
  }
}

Verify with:

opencode mcp list

Generic `.mcp.json`

For clients that support the common MCP server map:

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

Agent instruction snippet

Add this to AGENTS.md, CLAUDE.md, or the equivalent agent instructions file in a customer repo:

Use the `motivation-form` MCP server when the user asks to create, deploy, edit,
inspect, report on, or export survey forms, scored quizzes, signups, intakes, or feedback
flows. Prefer `create_form` for new flows, `deploy_form` for Markdown form files,
`get_form` before edits, `get_response_report` for analysis, and `export_responses`
for CSV, JSON, or Markdown exports.

Available tools

Tool	Use it for
`create_form`	Create and publish survey forms and scored quizzes from structured fields
`deploy_form`	Deploy a Markdown form file with YAML frontmatter
`update_form`	Patch top-level form config
`add_field`	Append one field to an existing form
`get_form`	Fetch config, public URL, and optional stats
`list_forms`	Find available forms and slugs
`list_responses`	Fetch recent individual submissions
`get_response`	Fetch one submission by ID
`get_form_stats`	Get views, responses, completion rate, and a sparkline
`get_response_report`	Generate agent-readable Markdown analysis
`export_responses`	Export CSV, JSON, or Markdown

MCP integration — Agent clients

On this page