Skip to main content
Glama
@cmssy/mcp-server

@cmssy/mcp-server

Official

Update form

update_form
Destructive

Update a form's name, slug, status, fields or settings by id or slug. Change only the settings keys you name; sending fields replaces the whole array.

Instructions

Update an existing form's name, slug, status, fields or settings. Name the settings keys you are changing - the rest keep their stored values. 'fields' is the opposite: it replaces the whole array, so send every field you want the form to keep.

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": {
      "idOrSlug": "<idOrSlug>"
    },
    "name": "update_form"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameNo
slugNo
fieldsNoReplacement fields array
statusNo
idOrSlugYesThe form's id or slug to update
settingsNo
descriptionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed38 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"
    • changedInput schema / properties / settings / properties / actionType / enum
      Previous value: -[
      -  "login",
      -  "register",
      -  "contact",
      -  "custom"
      -]New value: +[
      +  "contact",
      +  "custom"
      +]
    • addedInput schema / properties / settings / properties / emailConfigurationId / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / settings / properties / emailConfigurationId / type
      Removed value: -"string"
    • addedInput schema / properties / settings / properties / emailRecipients / items / format
      Added value: +"email"
    • addedInput schema / properties / settings / properties / emailRecipients / items / pattern
      Added value: +"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    • 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: +[
      +  "idOrSlug"
      +]
  2. First observedv0.73.1

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already flag destructiveHint=true, but the description adds the crucial detail the annotations cannot: settings keys are merged (omitted keys retain stored values) while fields is a full replacement that drops anything not resent. That is exactly the 'what gets destroyed' context an agent needs. It stops short of covering permissions, slug-collision behavior, or error semantics.

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?

Three short sentences with no filler; the mutable surface is front-loaded and the two contrasting update semantics are stated as a direct contrast. Every sentence earns its place.

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

Completeness4/5

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

For a 7-parameter tool with deep nested objects and no output schema, the description covers the primary footgun (partial vs. replace semantics) that would otherwise cause data loss. Gaps remain around identifier resolution and failure modes, but nothing essential to a correct call is missing.

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

Parameters4/5

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

Schema description coverage is only 29%, so the description has to compensate, and it does for the two riskiest parameters: it explains that settings is a partial merge and fields a wholesale replacement, which the schema does not state. It does not clarify idOrSlug resolution or the individual settings keys, so some of the low-coverage surface remains undocumented.

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 names a specific verb and resource ('Update an existing form') and enumerates the mutable surface (name, slug, status, fields, settings). That is enough to separate it from create_form/delete_form/get_form, though no sibling is named explicitly.

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

Usage Guidelines4/5

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

It sets clear context for invocation: target an existing form by idOrSlug and change only the listed attributes. The settings-versus-fields merge rule is effectively operational guidance on how to call it correctly, but no explicit when-not or alternative-tool routing is given.

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