MCP Server - Deformity Help

New to MCP? What is it?

MCP, or Model Context Protocol, is a standard way for AI assistants to connect to tools and data. Deformity's MCP server lets your chosen assistant work with your forms through plain-language requests, such as creating a form, reviewing submissions, or summarizing response trends. You stay in control of the connection and can disconnect it at any time.

Deformity's MCP server lets ChatGPT Work, Codex, 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. ChatGPT Work and Codex connect with OAuth, so you do not need to copy an API key into those products.

Server URL

https://deformity.ai/api/mcp

ChatGPT Work

ChatGPT Work may label this area Connectors or Plugins, depending on your workspace version.

Sign in to Deformity, then open ChatGPT Work in the same browser.
Open Settings → Connectors (or Plugins → Add MCP server).
Add https://deformity.ai/api/mcp as a remote MCP server.
Choose OAuth, complete the Deformity sign-in and consent screens, and approve the connection.
Start a new chat, enable the Deformity connector, and ask it to list your workspaces to verify the connection.

If you cannot add the server, your ChatGPT Work administrator may need to allow custom MCP servers or approve the connector.

Codex

Add https://deformity.ai/api/mcp as a remote MCP server in your Codex client.
Choose OAuth when Codex asks how to authenticate.
Complete the Deformity sign-in and consent screens in your browser.
Start a new Codex task, then ask it to call list_workspaces to verify that the connection works.

OAuth is supported by remote MCP clients. If your Codex client only accepts static headers, use the API-key setup below.

Claude and Claude Desktop

Open Settings → Connectors in Claude.
Select Add custom connector and enterhttps://deformity.ai/api/mcp as the connector URL.
Click Add, then Connect and complete the Deformity OAuth sign-in and consent screens.
In a chat, open Search and tools, enable the Deformity connector, and ask it to list your workspaces.

Claude Team and Enterprise workspaces may require an owner or primary owner to add the custom connector first. Claude Desktop remote connectors are also configured from Settings → Connectors. Do not add this remote server to claude_desktop_config.json.

Claude Code

Claude Code can authenticate remote MCP servers with OAuth from the/mcp command:

claude mcp add --transport http deformity https://deformity.ai/api/mcp
claude
> /mcp

Follow the browser sign-in flow shown by Claude Code, then enable the server. If your Claude Code version does not offer OAuth, use the API-key command in the section below.

API-key authentication for other clients

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.