MCP server

GudForm exposes an MCP endpoint so agents can build and fill forms with the same API key you use for REST. This page ships in the public core at gudlab/gudform-core. Tag that repo when the tool list changes so Cloud and self-host stay aligned.

Endpoint

  • Self-host / this tree: POST /api/mcp on your app URL
  • Cloud: POST https://gudform.com/api/mcp

Send Authorization: Bearer ff_.... Create a key under API Keys.

Tools

  • list_forms — forms in the account
  • get_form_schema — form plus questions
  • create_form — create a form, optionally with questions
  • set_questions — replace the question list
  • submit_response — submit answers
  • set_webhook — set or clear the form completion webhook

MCP clients

{
  "mcpServers": {
    "gudform": {
      "url": "https://your-host/api/mcp",
      "headers": {
        "Authorization": "Bearer ff_your_key"
      }
    }
  }
}

Same rate limits as the REST API. Spec: /openapi.yaml. Index for crawlers: /llms.txt.