MCP Server - Deformity Help

Deformity's MCP server lets AI assistants like Claude, Cursor, and other MCP-compatible tools work with your Deformity account. Once connected, an assistant can create forms, update existing forms, list workspaces, and fetch submissions when you ask it to analyze response data.

MCP access is free for all users and uses the same API keys as the External API.

Server URL

https://deformity.ai/api/mcp

Authentication

Open Account - API Keys.
Create a key in the Deformity External API section.
Copy the key immediately. It is only shown once.
Configure your MCP client to send Authorization: Bearer df_your_api_key.

Cursor and JSON-based clients

Use this configuration shape for clients that support remote HTTP MCP servers with custom headers.

{
  "mcpServers": {
    "deformity": {
      "url": "https://deformity.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer df_your_api_key"
      }
    }
  }
}

Claude Code

claude mcp add deformity --transport http https://deformity.ai/api/mcp \
  --header "Authorization: Bearer df_your_api_key"

Recommended workflow

Ask the assistant to call list_workspaces first so it can find the right workspaceId.
Ask it to create a form from a brief, or give it exact questions and tell it whether the form should be AI-driven or static.
Use get_form before making changes to an existing form.
Ask for submission analysis only when you want response data pulled into the assistant.

Available tools

Tool	What it does
`list_workspaces`	Find workspaces available to your API key.
`list_forms`	List active forms in your organization.
`get_form`	Fetch a form with settings and ordered points.
`create_form`	Create an AI or static form.
`update_form`	Update form metadata, settings, form type, or points.
`list_submissions`	Fetch recent submissions for analysis.
`get_submission`	Fetch one submission by ID.

Example prompts

Create a customer intake form in my Default workspace with questions for company name, goals, budget, timeline, and file upload.
Find my onboarding feedback form and add a required rating question.
Pull the latest submissions from my event survey and summarize the top themes.

Safety notes

The MCP server can create and update forms, but it does not expose deletion tools. Submission data is only fetched when you ask your assistant to use the submission tools.

More reference

Form payloads use the same shape as the External API. Use that reference for supported form fields, settings, point types, and point body fields.