Skip to main content
Glama

Update Project Metadata

update_project_metadata

Update project settings; current values appear at the top of list_files. Changes reach the published app at the next publish. Settings marked "on request" change only when the user asks about that subject.

  • updates (flat keys): title (2-100 chars), description, iconUrl (app icon: favicon, home-screen and native icon; a /_cdn/static/… path from upload_asset, generate_image or request_user_upload, or an https URL; null resets), splashUrl (native splash, same forms), mobileAppId, enableSSR, flootAiDisallowed (true opts out of @floot/ai), iOS Info.plist NS…UsageDescription strings (null removes) and UIViewControllerBasedStatusBarAppearance (boolean, null restores). Invalid keys are reported and skipped. After the first iOS / Android publish, edit static/__dev/native/ios-info.plist or android-manifest.xml instead (get_guides("ios-info-plist"), get_guides("android-manifest")).

  • shareTarget: native share-sheet target; ship it with the handler in app code (get_guides("share-target")).

  • nativeSystemBars: 'inset' (default) or 'edge-to-edge', which needs safe-area padding in the app (get_guides("native-system-bars")). ios.scrollEdgeEffect 'hidden' removes the iOS 26+ blur under the status bar.

  • serverMemoryMb: expert setting, only when the user explicitly asks to change the server memory: too low stops the backend and can cost more (get_guides("server-memory")).

  • analyticsMode: on request (analytics, cookies, consent; get_guides("analytics")).

  • iosDeviceFamily: before 'iphone' or 'ipad', ask whether the app is live on the App Store supporting the device it would drop; if it is, it cannot drop it. The only way to make it iPhone-only or iPad-only.

  • homeScreenName: the name under the installed app's icon (iOS + Android), also after the first mobile publish; keeps the bundle id and store listing names. null = default (store listing title, else project name).

  • routePrefetch: on request (page prefetching, load performance; get_guides("route-prefetch")).

  • dependencyOverrides: on request, to fix a vulnerable or conflicting nested package (get_guides("dependency-overrides")).

  • securityHeaders: on request (iframes, CSP, a security scan, referrer; get_guides("security-headers")). Never in the preview.

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": {
      "projectId": "<projectId>"
    },
    "name": "update_project_metadata"
  }
}

Input Schema

NameRequiredDescriptionDefault
updatesNoFlat fields (see the description).
projectIdYes
shareTargetNo{ enabled: false } removes it.
analyticsModeNo
routePrefetchNoMerged over the current value; null restores the default.
homeScreenNameNo
serverMemoryMbNoMemory (MB) of the project's server Lambda, 512–4096. EXPERT SETTING: only on an explicit user request to change the server memory (see the tool description for the risks); never touch it otherwise. Omit to leave unchanged; null restores the platform default.
iosDeviceFamilyNo
securityHeadersNoA field passed replaces, null removes, left out is kept. null restores the platform defaults.
nativeSystemBarsNoReplaced whole; android / ios override the top level per platform. { mode: 'inset' } restores the default.
dependencyOverridesNo{ "parent>package": exact or ^/~ version, or null to remove }; the parent is a direct dependency. null removes all.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / nativeSystemBars / properties / ios / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "color": {
      -        "type": "string"
      -      },
      -      "iconStyle": {
      -        "enum": [
      -          "light",
      -          "dark"
      -        ],
      -        "type": "string"
      -      },
      -      "mode": {
      -        "enum": [
      -          "inset",
      -          "edge-to-edge"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "color": {
      +        "type": "string"
      +      },
      +      "iconStyle": {
      +        "enum": [
      +          "light",
      +          "dark"
      +        ],
      +        "type": "string"
      +      },
      +      "mode": {
      +        "enum": [
      +          "inset",
      +          "edge-to-edge"
      +        ],
      +        "type": "string"
      +      },
      +      "scrollEdgeEffect": {
      +        "description": "iOS only: 'hidden' removes the iOS 26+ blur under the status bar.",
      +        "enum": [
      +          "automatic",
      +          "hidden"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed1 schema field changed
    • changedInput schema / properties / iosDeviceFamily / enum
      Previous value: -[
      -  "iphone-and-ipad",
      -  "iphone"
      -]New value: +[
      +  "iphone-and-ipad",
      +  "iphone",
      +  "ipad"
      +]
  3. Changed1 schema field changed
    • addedInput schema / properties / homeScreenName
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 30,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
  4. Changed15 schema fields changed
    • removedInput schema / properties / analyticsMode / description
      Removed value: -"Built-in visitor analytics mode for the published app: 'storage' (default, session id in localStorage — needs a consent banner for EU/UK visitors), 'memory' (nothing stored on the device, no consent needed) or 'off' (no analytics). Omit to leave unchanged."
    • changedInput schema / properties / dependencyOverrides / description
      Previous value: -"Published app's pnpm overrides: { \"parent>package\": \"exact version\" | \"^x.y.z\" | \"~x.y.z\" | null }, the parent being one of the project's own dependencies; merged over the current value (null removes an entry); null for the whole parameter removes them all. Omit to leave unchanged."New value: +"{ \"parent>package\": exact or ^/~ version, or null to remove }; the parent is a direct dependency. null removes all."
    • removedInput schema / properties / iosDeviceFamily / description
      Removed value: -"Devices the native iOS app is built for: 'iphone-and-ipad' (default) or 'iphone' (iPhone only). Not possible for an app already released on the App Store with iPad support. Omit to leave unchanged."
    • changedInput schema / properties / nativeSystemBars / description
      Previous value: -"Native system-bars config, replaced whole. Omit to leave unchanged; { mode: 'inset' } with no color restores the default. Runtime strip color (dark theme): see get_guides(\"native-system-bars\")."New value: +"Replaced whole; android / ios override the top level per platform. { mode: 'inset' } restores the default."
    • removedInput schema / properties / nativeSystemBars / properties / android / description
      Removed value: -"Android-only override of mode/color/iconStyle (e.g. { mode: 'inset' } while iOS is edge-to-edge). Unset fields come from the top level."
    • changedInput schema / properties / nativeSystemBars / properties / color / description
      Previous value: -"Inset mode only: #rrggbb paint of the strips under the bars. Default #000000."New value: +"Inset only: #rrggbb of the strips under the bars, default #000000."
    • changedInput schema / properties / nativeSystemBars / properties / iconStyle / description
      Previous value: -"Color of the bar ICONS. Inset: defaults to contrast with `color`. Edge-to-edge: defaults to 'dark'."New value: +"Color of the bar icons."
    • removedInput schema / properties / nativeSystemBars / properties / ios / description
      Removed value: -"iOS-only override of mode/color/iconStyle. Unset fields come from the top level."
    • changedInput schema / properties / routePrefetch / description
      Previous value: -"Published app's page-code prefetching: { mode?: 'auto' | 'all' | 'viewport' | 'intent' | 'off', skipAutomation?: boolean }, merged over the current value; null restores the default. Omit to leave unchanged."New value: +"Merged over the current value; null restores the default."
    • changedInput schema / properties / securityHeaders / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "csp": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {
      -              "anyOf": [
      -                {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Directive -> its COMPLETE source list, replacing the platform's for that directive, e.g. { \"form-action\": [\"'self'\"] }. A directive set to null goes back to the platform's; directives left out are kept."
      -      },
      -      "cspReportOnly": {
      -        "description": "true: send `csp` as Content-Security-Policy-Report-Only (nothing blocked) to try it on the published app first.",
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "embedding": {
      -        "anyOf": [
      -          {
      -            "anyOf": [
      -              {
      -                "enum": [
      -                  "anyone",
      -                  "self",
      -                  "none"
      -                ],
      -                "type": "string"
      -              },
      -              {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": "array"
      -              }
      -            ]
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "'anyone' (default), 'self', 'none', or a list of https origins (own origin always included)."
      -      },
      -      "referrerPolicy": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "no-referrer",
      -              "no-referrer-when-downgrade",
      -              "origin",
      -              "origin-when-cross-origin",
      -              "same-origin",
      -              "strict-origin",
      -              "strict-origin-when-cross-origin",
      -              "unsafe-url"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "csp": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {
      +              "anyOf": [
      +                {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Directive -> its COMPLETE source list, replacing the platform's; null restores that directive."
      +      },
      +      "cspReportOnly": {
      +        "description": "Report only: nothing is blocked.",
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "embedding": {
      +        "anyOf": [
      +          {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "anyone",
      +                  "self",
      +                  "none"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              }
      +            ]
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "'anyone' (default), 'self', 'none', or https origins."
      +      },
      +      "referrerPolicy": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "no-referrer",
      +              "no-referrer-when-downgrade",
      +              "origin",
      +              "origin-when-cross-origin",
      +              "same-origin",
      +              "strict-origin",
      +              "strict-origin-when-cross-origin",
      +              "unsafe-url"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / securityHeaders / description
      Previous value: -"The published app's own page headers. Omit to leave unchanged; null restores the platform defaults. Fields: embedding ('anyone' | 'self' | 'none' | list of https origins), csp ({ directive: [complete source list] } replacing the platform's for that directive; a directive set to null goes back to the platform's), cspReportOnly (boolean), referrerPolicy. A field passed as null is removed; a field left out is kept."New value: +"A field passed replaces, null removes, left out is kept. null restores the platform defaults."
    • changedInput schema / properties / shareTarget / description
      Previous value: -"Share-sheet target config (iOS Share Extension + Android share sheet). Omit to leave unchanged; { enabled: false } removes it."New value: +"{ enabled: false } removes it."
    • changedInput schema / properties / shareTarget / properties / allowMultiple / description
      Previous value: -"Also accept multi-select shares. Default true."New value: +"Default true."
    • changedInput schema / properties / shareTarget / properties / mimeTypes / description
      Previous value: -"MIME patterns to accept, e.g. [\"image/*\",\"video/*\"] (default). Allowed: image/*, video/*, audio/*, text/plain, application/pdf."New value: +"Default [\"image/*\",\"video/*\"]. Allowed: image/*, video/*, audio/*, text/plain, application/pdf."
    • changedInput schema / properties / updates / description
      Previous value: -"Flat metadata fields (see the tool description)."New value: +"Flat fields (see the description)."
  5. Changed1 schema field changed
    • addedInput schema / properties / dependencyOverrides
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Published app's pnpm overrides: { \"parent>package\": \"exact version\" | \"^x.y.z\" | \"~x.y.z\" | null }, the parent being one of the project's own dependencies; merged over the current value (null removes an entry); null for the whole parameter removes them all. Omit to leave unchanged."
      +}
  6. Changed3 schema fields changed
    • changedInput schema / properties / nativeSystemBars / description
      Previous value: -"Native system-bars config. Omit to leave unchanged; { mode: 'inset' } with no color restores the default."New value: +"Native system-bars config, replaced whole. Omit to leave unchanged; { mode: 'inset' } with no color restores the default. Runtime strip color (dark theme): see get_guides(\"native-system-bars\")."
    • addedInput schema / properties / nativeSystemBars / properties / android
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "color": {
      +          "type": "string"
      +        },
      +        "iconStyle": {
      +          "enum": [
      +            "light",
      +            "dark"
      +          ],
      +          "type": "string"
      +        },
      +        "mode": {
      +          "enum": [
      +            "inset",
      +            "edge-to-edge"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Android-only override of mode/color/iconStyle (e.g. { mode: 'inset' } while iOS is edge-to-edge). Unset fields come from the top level."
      +}
    • addedInput schema / properties / nativeSystemBars / properties / ios
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "color": {
      +          "type": "string"
      +        },
      +        "iconStyle": {
      +          "enum": [
      +            "light",
      +            "dark"
      +          ],
      +          "type": "string"
      +        },
      +        "mode": {
      +          "enum": [
      +            "inset",
      +            "edge-to-edge"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "iOS-only override of mode/color/iconStyle. Unset fields come from the top level."
      +}
  7. Changed1 schema field changed
    • addedInput schema / properties / routePrefetch
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "mode": {
      +          "enum": [
      +            "auto",
      +            "all",
      +            "viewport",
      +            "intent",
      +            "off"
      +          ],
      +          "type": "string"
      +        },
      +        "skipAutomation": {
      +          "type": "boolean"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Published app's page-code prefetching: { mode?: 'auto' | 'all' | 'viewport' | 'intent' | 'off', skipAutomation?: boolean }, merged over the current value; null restores the default. Omit to leave unchanged."
      +}
  8. Changed1 schema field changed
    • addedInput schema / properties / securityHeaders
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "csp": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {
      +                "anyOf": [
      +                  {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Directive -> its COMPLETE source list, replacing the platform's for that directive, e.g. { \"form-action\": [\"'self'\"] }. A directive set to null goes back to the platform's; directives left out are kept."
      +        },
      +        "cspReportOnly": {
      +          "description": "true: send `csp` as Content-Security-Policy-Report-Only (nothing blocked) to try it on the published app first.",
      +          "type": [
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        "embedding": {
      +          "anyOf": [
      +            {
      +              "anyOf": [
      +                {
      +                  "enum": [
      +                    "anyone",
      +                    "self",
      +                    "none"
      +                  ],
      +                  "type": "string"
      +                },
      +                {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              ]
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "'anyone' (default), 'self', 'none', or a list of https origins (own origin always included)."
      +        },
      +        "referrerPolicy": {
      +          "anyOf": [
      +            {
      +              "enum": [
      +                "no-referrer",
      +                "no-referrer-when-downgrade",
      +                "origin",
      +                "origin-when-cross-origin",
      +                "same-origin",
      +                "strict-origin",
      +                "strict-origin-when-cross-origin",
      +                "unsafe-url"
      +              ],
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "The published app's own page headers. Omit to leave unchanged; null restores the platform defaults. Fields: embedding ('anyone' | 'self' | 'none' | list of https origins), csp ({ directive: [complete source list] } replacing the platform's for that directive; a directive set to null goes back to the platform's), cspReportOnly (boolean), referrerPolicy. A field passed as null is removed; a field left out is kept."
      +}
  9. Changed1 schema field changed
    • addedInput schema / properties / iosDeviceFamily
      Added value: +{
      +  "description": "Devices the native iOS app is built for: 'iphone-and-ipad' (default) or 'iphone' (iPhone only). Not possible for an app already released on the App Store with iPad support. Omit to leave unchanged.",
      +  "enum": [
      +    "iphone-and-ipad",
      +    "iphone"
      +  ],
      +  "type": "string"
      +}
  10. Changed1 schema field changed
    • addedInput schema / properties / analyticsMode
      Added value: +{
      +  "description": "Built-in visitor analytics mode for the published app: 'storage' (default, session id in localStorage — needs a consent banner for EU/UK visitors), 'memory' (nothing stored on the device, no consent needed) or 'off' (no analytics). Omit to leave unchanged.",
      +  "enum": [
      +    "storage",
      +    "memory",
      +    "off"
      +  ],
      +  "type": "string"
      +}
  11. Changed1 schema field changed
    • addedInput schema / properties / serverMemoryMb
      Added value: +{
      +  "anyOf": [
      +    {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "string"
      +        }
      +      ]
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Memory (MB) of the project's server Lambda, 512–4096. EXPERT SETTING: only on an explicit user request to change the server memory (see the tool description for the risks); never touch it otherwise. Omit to leave unchanged; null restores the platform default."
      +}
  12. Changed1 schema field changed
    • addedInput schema / properties / shareTarget
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Share-sheet target config (iOS Share Extension + Android share sheet). Omit to leave unchanged; { enabled: false } removes it.",
      +  "properties": {
      +    "allowMultiple": {
      +      "description": "Also accept multi-select shares. Default true.",
      +      "type": "boolean"
      +    },
      +    "enabled": {
      +      "type": "boolean"
      +    },
      +    "mimeTypes": {
      +      "description": "MIME patterns to accept, e.g. [\"image/*\",\"video/*\"] (default). Allowed: image/*, video/*, audio/*, text/plain, application/pdf.",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "enabled"
      +  ],
      +  "type": "object"
      +}
  13. Changed1 schema field changed
    • removedInput schema / properties / shareTarget
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "Share-sheet target config (iOS Share Extension + Android share sheet). Omit to leave unchanged; { enabled: false } removes it.",
      -  "properties": {
      -    "allowMultiple": {
      -      "description": "Also accept multi-select shares. Default true.",
      -      "type": "boolean"
      -    },
      -    "enabled": {
      -      "type": "boolean"
      -    },
      -    "mimeTypes": {
      -      "description": "MIME patterns to accept, e.g. [\"image/*\",\"video/*\"] (default). Allowed: image/*, video/*, audio/*, text/plain, application/pdf.",
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "required": [
      -    "enabled"
      -  ],
      -  "type": "object"
      -}
  14. Changed1 schema field changed
    • addedInput schema / properties / shareTarget
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Share-sheet target config (iOS Share Extension + Android share sheet). Omit to leave unchanged; { enabled: false } removes it.",
      +  "properties": {
      +    "allowMultiple": {
      +      "description": "Also accept multi-select shares. Default true.",
      +      "type": "boolean"
      +    },
      +    "enabled": {
      +      "type": "boolean"
      +    },
      +    "mimeTypes": {
      +      "description": "MIME patterns to accept, e.g. [\"image/*\",\"video/*\"] (default). Allowed: image/*, video/*, audio/*, text/plain, application/pdf.",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "enabled"
      +  ],
      +  "type": "object"
      +}
  15. Changed3 schema fields changed
    • addedInput schema / properties / nativeSystemBars
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Native system-bars config. Omit to leave unchanged; { mode: 'inset' } with no color restores the default.",
      +  "properties": {
      +    "color": {
      +      "description": "Inset mode only: #rrggbb paint of the strips under the bars. Default #000000.",
      +      "type": "string"
      +    },
      +    "iconStyle": {
      +      "description": "Color of the bar ICONS. Inset: defaults to contrast with `color`. Edge-to-edge: defaults to 'dark'.",
      +      "enum": [
      +        "light",
      +        "dark"
      +      ],
      +      "type": "string"
      +    },
      +    "mode": {
      +      "enum": [
      +        "inset",
      +        "edge-to-edge"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "mode"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / updates / description
      Added value: +"Flat metadata fields (see the tool description)."
    • changedInput schema / required
      Previous value: -[
      -  "projectId",
      -  "updates"
      -]New value: +[
      +  "projectId"
      +]
  16. First observed

TDQS

A4.7/5.0
Behavior4/5

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

The annotations only declare a non-read-only, non-open-world, non-destructive mutation, so the description carries most of the burden and does so well: it discloses publish-timing semantics, that 'on request' settings only change on user request, that invalid keys are 'reported and skipped', and that null resets/removes values. Minor gap: it does not state permission requirements or whether a partial failure leaves earlier keys applied.

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

Conciseness4/5

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

Content is dense but almost every clause carries operational information, and purpose plus publish semantics are front-loaded before the setting catalog. The dash-prefixed setting list runs together in a single block, which slightly hurts scannability, but there is little genuine filler to cut.

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

Completeness5/5

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

Given 11 parameters, nested objects, and no output schema, the definition covers every setting group, explains what happens on invalid input, and cross-references the guide tools and asset tools needed for the complex fields. An agent has everything required to invoke this correctly without opening another definition.

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

Parameters5/5

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

With 11 parameters and only 64% schema description coverage, the description compensates heavily: it documents accepted forms for iconUrl/splashUrl (upload_asset, generate_image, request_user_upload, or https), title length bounds, null-reset behavior per key, the 'parent>package' dependencyOverrides format, and per-platform nativeSystemBars overrides. This adds real meaning beyond the JSON schema rather than restating it.

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

Purpose5/5

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

Opens with a specific verb+resource ('Update project settings') and immediately clarifies scope by pointing to list_files for current values and noting when changes reach the published app. It then enumerates the distinct setting groups (native bars, share target, iOS device family, security headers), so an agent can tell exactly what this tool owns versus get_guides or edit_file.

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

Usage Guidelines5/5

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

Provides explicit gating for the risky settings: serverMemoryMb is 'only when the user explicitly asks', several settings are tagged 'on request', iosDeviceFamily requires asking about App Store listings first, and securityHeaders must 'never' go in the preview. It also names a concrete alternative path ('after the first iOS / Android publish, edit static/__dev/native/ios-info.plist … instead') with the guide to consult.

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