Skip to main content
Glama

Update Settings

updateSettings
DestructiveIdempotent

Update Settings

Update general project settings. Omit fields you do not want to change.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameNoBusiness or project display name, 3 to 50 characters. Omit to leave unchanged.
websiteNoPublic business website URL, up to 100 characters. Omit to leave unchanged.
currencyNoThree-letter ISO 4217 currency code for charges and reporting, such as USD. Omit to leave unchanged. Accepts a string from 3 to 3 characters.
descriptionNoBusiness description used in AI and customer-facing flows, 50 to 1000 characters when set. Null clears it.
ga_measurement_idNoGoogle Analytics measurement ID, up to 50 characters, such as G-ABCDEF1234. Null clears it.
review_visibilityNoDefault visibility for newly collected reviews. Omit to leave unchanged.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
codeNoApplication-level status code returned by this API.
dataNoGeneral project settings.
successNoIndicates whether the request completed successfully.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed19 schema fields changed
    • addedInput schema / properties / currency / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / currency / description
      Previous value: -"ISO 4217 currency code."New value: +"Three-letter ISO 4217 currency code for charges and reporting, such as USD. Omit to leave unchanged. Accepts a string from 3 to 3 characters."
    • removedInput schema / properties / currency / type
      Removed value: -"string"
    • addedInput schema / properties / description / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / description / description
      Previous value: -"Business description (50–1000 characters when set)."New value: +"Business description used in AI and customer-facing flows, 50 to 1000 characters when set. Null clears it."
    • removedInput schema / properties / description / type
      Removed value: -"string"
    • addedInput schema / properties / ga_measurement_id / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / ga_measurement_id / description
      Previous value: -"Google Analytics measurement ID."New value: +"Google Analytics measurement ID, up to 50 characters, such as G-ABCDEF1234. Null clears it."
    • removedInput schema / properties / ga_measurement_id / type
      Removed value: -"string"
    • addedInput schema / properties / name / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / name / description
      Previous value: -"Business or project display name."New value: +"Business or project display name, 3 to 50 characters. Omit to leave unchanged."
    • removedInput schema / properties / name / type
      Removed value: -"string"
    • addedInput schema / properties / review_visibility / anyOf
      Added value: +[
      +  {
      +    "enum": [
      +      "show",
      +      "show-positive",
      +      "hide"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / review_visibility / description
      Previous value: -"Default review visibility (`show`, `show-positive`, or `hide`)."New value: +"Default visibility for newly collected reviews. Omit to leave unchanged."
    • removedInput schema / properties / review_visibility / type
      Removed value: -"string"
    • addedInput schema / properties / website / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / website / description
      Previous value: -"Public business website URL."New value: +"Public business website URL, up to 100 characters. Omit to leave unchanged."
    • removedInput schema / properties / website / type
      Removed value: -"string"
    • changedOutput schema / properties / data / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "currency": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "ISO 4217 currency code for charges and reporting."
      -      },
      -      "description": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Business description used in AI and customer-facing flows."
      -      },
      -      "ga_measurement_id": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Google Analytics measurement ID (for example `G-XXXXXXXXXX`)."
      -      },
      -      "id": {
      -        "anyOf": [
      -          {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Unique numeric identifier for this project."
      -      },
      -      "name": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Business or project display name."
      -      },
      -      "review_visibility": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Default visibility for collected reviews (`show`, `show-positive`, or `hide`)."
      -      },
      -      "uuid": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Stable UUID for this project."
      -      },
      -      "website": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Public business website URL."
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "currency": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "ISO 4217 currency code for charges and reporting."
      +      },
      +      "description": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Business description used in AI and customer-facing flows."
      +      },
      +      "ga_measurement_id": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Google Analytics measurement ID (for example `G-XXXXXXXXXX`)."
      +      },
      +      "id": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Unique numeric identifier for this project."
      +      },
      +      "name": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Business or project display name."
      +      },
      +      "review_visibility": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Default visibility applied to newly collected reviews."
      +      },
      +      "uuid": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Stable UUID for this project."
      +      },
      +      "website": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Public business website URL."
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Added

TDQS

C2.6/5.0
Behavior2/5

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

Annotations already declare destructiveHint=true, idempotentHint=true, and openWorldHint=true. The description adds essentially nothing beyond that: it does not say what destructive means here (e.g., that passing null clears website, description, or ga_measurement_id), nor whether permissions are required. Its only behavioral claim, partial-field omission, is already repeated in every schema property description.

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

Conciseness3/5

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

It is short and front-loaded, but the first line just echoes the title ("Update Settings") before restating the same idea as "Update general project settings," so roughly half the text is redundant. Not bloated, but not every sentence earns its place.

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?

With an output schema present and 100% schema coverage, return values and parameter details are covered elsewhere, and annotations cover the safety profile. What remains missing is scope identity: which settings this mutates versus updateMeta, updateBranding, and updateLocation, leaving the agent to guess.

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 coverage is 100% with per-field constraints, formats, and explicit "omit to leave unchanged" / "null clears it" notes, so the structured data carries the parameter burden. The description's "Omit fields you do not want to change" merely restates that baseline, adding no new semantics. Baseline 3 is appropriate.

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

Purpose3/5

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

"Update general project settings" gives a verb and a resource, but "general project settings" is vague and does nothing to separate it from sibling mutators like updateBranding, updateMeta, or updateLocation. An agent cannot tell from the description alone which settings object this tool owns.

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

Usage Guidelines2/5

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

There is no when-to-use guidance and no mention of alternatives; getSettings (the read counterpart) and the other update* tools are never referenced. "Omit fields you do not want to change" describes patch mechanics rather than when to pick this tool over its siblings.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources