Skip to main content
Glama
@cmssy/mcp-server

@cmssy/mcp-server

Official

Create form

create_form
Destructive

Define a new form by name and slug, optionally adding fields, conditional show/require rules, and settings for actions and notifications.

Instructions

Create a new form with a name and slug. Optional: field definitions, per-field showWhen/requiredWhen conditions, and settings (action type, notifications). Fields can also be added later in the Forms editor.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "name": "<name>",
      "slug": "<slug>"
    },
    "name": "create_form"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameYesThe form's display name
slugYesURL-friendly slug, unique within the workspace
fieldsNoForm field definitions
settingsNoForm settings (action type, notifications, etc.)
descriptionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed35 schema fields changedv0.73.2
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / description / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / description / type
      Removed value: -"string"
    • addedInput schema / properties / fields / items / properties / defaultValue / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / fields / items / properties / defaultValue / type
      Removed value: -"string"
    • changedInput schema / properties / fields / items / properties / fieldType / enum
      Previous value: -[
      -  "text",
      -  "email",
      -  "password",
      -  "textarea",
      -  "number",
      -  "phone",
      -  "url",
      -  "date",
      -  "datetime",
      -  "select",
      -  "multiselect",
      -  "checkbox",
      -  "radio",
      -  "file",
      -  "hidden"
      -]New value: +[
      +  "text",
      +  "email",
      +  "password",
      +  "textarea",
      +  "number",
      +  "phone",
      +  "url",
      +  "date",
      +  "datetime",
      +  "select",
      +  "multiselect",
      +  "boolean",
      +  "radio",
      +  "file",
      +  "hidden"
      +]
    • addedInput schema / properties / fields / items / properties / helpText / additionalProperties / type
      Added value: +"string"
    • addedInput schema / properties / fields / items / properties / label / additionalProperties / type
      Added value: +"string"
    • addedInput schema / properties / fields / items / properties / options / items / properties / label / additionalProperties / type
      Added value: +"string"
    • addedInput schema / properties / fields / items / properties / placeholder / additionalProperties / type
      Added value: +"string"
    • addedInput schema / properties / fields / items / properties / requiredWhen
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "conditions": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "equals": {},
      +              "field": {
      +                "description": "The name of the field to test",
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "isEmpty": {
      +                "type": "boolean"
      +              },
      +              "notEmpty": {
      +                "type": "boolean"
      +              },
      +              "notEquals": {}
      +            },
      +            "required": [
      +              "field"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "logic": {
      +          "description": "all = every condition must hold, any = one is enough",
      +          "enum": [
      +            "all",
      +            "any"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "logic",
      +        "conditions"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Require the field only while this condition group holds"
      +}
    • removedInput schema / properties / fields / items / properties / showIf
      Removed value: -{
      -  "additionalProperties": {},
      -  "propertyNames": {
      -    "type": "string"
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / fields / items / properties / showWhen
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "conditions": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "equals": {},
      +              "field": {
      +                "description": "The name of the field to test",
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "isEmpty": {
      +                "type": "boolean"
      +              },
      +              "notEmpty": {
      +                "type": "boolean"
      +              },
      +              "notEquals": {}
      +            },
      +            "required": [
      +              "field"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "logic": {
      +          "description": "all = every condition must hold, any = one is enough",
      +          "enum": [
      +            "all",
      +            "any"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "logic",
      +        "conditions"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Show the field only while this condition group holds"
      +}
    • addedInput schema / properties / fields / items / properties / validation / properties / customMessage / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / fields / items / properties / validation / properties / customMessage / type
      Removed value: -"string"
    • addedInput schema / properties / fields / items / properties / validation / properties / maxLength / anyOf
      Added value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / fields / items / properties / validation / properties / maxLength / type
      Removed value: -"number"
    • addedInput schema / properties / fields / items / properties / validation / properties / maxValue / anyOf
      Added value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / fields / items / properties / validation / properties / maxValue / type
      Removed value: -"number"
    • addedInput schema / properties / fields / items / properties / validation / properties / minLength / anyOf
      Added value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / fields / items / properties / validation / properties / minLength / type
      Removed value: -"number"
    • addedInput schema / properties / fields / items / properties / validation / properties / minValue / anyOf
      Added value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / fields / items / properties / validation / properties / minValue / type
      Removed value: -"number"
    • addedInput schema / properties / fields / items / properties / validation / properties / pattern / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / fields / items / properties / validation / properties / pattern / type
      Removed value: -"string"
    • addedInput schema / properties / settings / properties / emailConfigurationId / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / settings / properties / emailConfigurationId / type
      Removed value: -"string"
    • removedInput schema / properties / settings / properties / enableCaptcha
      Removed value: -{
      -  "type": "boolean"
      -}
    • addedInput schema / properties / settings / properties / errorMessage / additionalProperties / type
      Added value: +"string"
    • addedInput schema / properties / settings / properties / redirectUrl / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / settings / properties / redirectUrl / type
      Removed value: -"string"
    • addedInput schema / properties / settings / properties / submitButtonLabel / additionalProperties / type
      Added value: +"string"
    • addedInput schema / properties / settings / properties / successMessage / additionalProperties / type
      Added value: +"string"
    • removedInput schema / properties / settings / properties / webhookUrl
      Removed value: -{
      -  "type": "string"
      -}
    • addedInput schema / required
      Added value: +[
      +  "name",
      +  "slug"
      +]
  2. First observedv0.73.1

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare readOnlyHint=false and destructiveHint=true, so the agent already knows this is a write operation. The description adds modest value by clarifying that fields and settings are optional and can be appended afterwards, but it never addresses the destructive flag, what happens on slug collision, whether a partially-specified form is still created, or what the call returns — meaningful gaps for a mutation tool with a deeply nested payload.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with no filler. The required inputs are front-loaded and the optional payload is described in the second sentence, so an agent can stop reading after sentence one for the minimum viable call.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has five parameters including deeply nested field and settings objects, and no output schema, so the description carries more weight than usual. It adequately covers the surface shape but omits what a successful call yields (form ID or created object) and says nothing about failure modes such as a duplicate slug, which an agent needs to plan a retry or error message.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 80%, so the schema already carries most parameter meaning and a baseline of 3 applies. The description does group the payload conceptually — field definitions, per-field showWhen/requiredWhen conditions, and settings covering action type and notifications — which helps an agent orient within the nested structure, but it adds no syntax or constraint detail beyond what the schema states.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource ('Create a new form') and immediately identifies the two required inputs (name and slug), which matches the schema's required list. It does not contrast itself with the obvious sibling update_form or explain why one would create versus update, but the operation itself is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage context is implied rather than stated: the closing sentence 'Fields can also be added later in the Forms editor' hints that fields are optional at creation time, which is useful workflow guidance. However, there is no explicit when-to-use versus update_form, no mention that slug must be unique (that fact lives only in the schema), and no stated prerequisites or side effects for the caller to weigh.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools