Skip to main content
Glama

Update Padlet Appearance

update_padlet_appearance

Changes how a padlet looks: its color scheme, post size, font, wallpaper and, on a map padlet, its map style.

  • font takes the internal name. Any padlet except a sandbox takes alps (sans-serif), thames (serif), niagara (handwritten) or fuji (monospace). A sandbox padlet takes alps (Modern), thames (Classic), shantell (Playful) or courier (Technical).

  • Give wallpaper or wallpaper_image_url, not both. A map padlet takes map_style instead.

  • map_style takes the id of one of these map styles: 100 The Usual (light), 101 Silver (light), 102 Black Metal (dark), 103 Medieval (light), 104 Retro (light), 105 Tron (dark), 106 Night (dark), 107 Amusement Park (light), 108 Video Game (light), 109 Satellite (light), 110 Watercolor (light).

  • Pass only the settings that should change.

  • Returns { success: true, applied: [part, ...] }. A part listed under not_applied, as { part, code, reason }, did not change: tell the user why, and never say it changed. When no part changed, success is false and the message gives each part's reason.

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": {
      "wall_url": "<wall_url>"
    },
    "name": "update_padlet_appearance"
  }
}

Input Schema

NameRequiredDescriptionDefault
fontNoSet the padlet font using the internal font name. Refer to the instructions for the mapping between UI names and internal values.
wall_urlYesThe padlet's link (e.g. https://padlet.com/foo/bar-a1b2c3): the link you were given, the `wall_url` a previous call returned, or a link the user pasted. Not a breakout-room or submission link, and not a padlet id: no tool takes a wall_id.
map_styleNoThe id of the theme to update the padlet to.
post_sizeNoSet the post width. Not supported for canvas, table, or sandbox padlets.
telemetryNoOptional. Padlet records this to improve its tools; it does not change what the tool does.
wallpaperNoA short 1-3 word phrase describing the visual subject of the wallpaper (e.g. 'math equations', 'sunset ocean', 'tropical plants'). Focus on the subject, not the medium.
color_schemeNoSet the padlet color scheme. Not supported for sandbox or map padlets.
wallpaper_image_urlNoA picture to use as the wallpaper: the url an upload tool returned, or a public https address of an image.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / telemetry
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Optional. Padlet records this to improve its tools; it does not change what the tool does.",
      +  "properties": {
      +    "intent": {
      +      "description": "Explain the task and why you are calling this tool. Omit full queries, large inputs, personal information, and secrets.",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed3 schema fields changed
    • addedInput schema / properties / map_style
      Added value: +{
      +  "description": "The id of the theme to update the padlet to.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / wallpaper
      Added value: +{
      +  "description": "A short 1-3 word phrase describing the visual subject of the wallpaper (e.g. 'math equations', 'sunset ocean', 'tropical plants'). Focus on the subject, not the medium.",
      +  "type": "string"
      +}
    • addedInput schema / properties / wallpaper_image_url
      Added value: +{
      +  "description": "A picture to use as the wallpaper: the url an upload tool returned, or a public https address of an image.",
      +  "type": "string"
      +}
  3. Changed2 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / wall_url / description
      Previous value: -"The padlet's link (e.g. https://padlet.com/foo/bar-a1b2c3): the link you were given, the `wall_url` a previous call returned, or a link the user pasted. Not a breakout-room or submission link."New value: +"The padlet's link (e.g. https://padlet.com/foo/bar-a1b2c3): the link you were given, the `wall_url` a previous call returned, or a link the user pasted. Not a breakout-room or submission link, and not a padlet id: no tool takes a wall_id."
  4. Changed3 schema fields changed
    • removedInput schema / properties / wall_id
      Removed value: -{
      -  "description": "The id of the wall to update",
      -  "type": "integer"
      -}
    • addedInput schema / properties / wall_url
      Added value: +{
      +  "description": "The padlet's link (e.g. https://padlet.com/foo/bar-a1b2c3): the link you were given, the `wall_url` a previous call returned, or a link the user pasted. Not a breakout-room or submission link.",
      +  "maxLength": 2048,
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "wall_id"
      -]New value: +[
      +  "wall_url"
      +]
  5. First observed

TDQS

A4.8/5.0
Behavior5/5

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

Annotations already declare readOnlyHint=false, destructiveHint=false and idempotentHint=false, and the description goes well beyond them: it documents the return shape { success, applied }, the not_applied structure { part, code, reason }, and an explicit instruction to never claim a part changed when it did not. It also discloses per-padlet-type restrictions (sandbox, map, canvas, table) that the annotations cannot express.

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?

Front-loaded one-line purpose followed by short, scannable bullets, each carrying a distinct operational rule. The long map-style enumeration is dense but every id is needed to make the call correctly, so nothing is padding.

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?

Covers all 8 parameters including the nested telemetry intent field implicitly, describes the return value in the absence of an output schema, and pre-empts the main failure mode (partial application). Nothing an agent needs in order to invoke this correctly and report results honestly is missing.

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?

Although schema coverage is 100% (baseline 3), the description adds substantial meaning the schema lacks: the mapping of internal font names to UI names and how that mapping shifts for sandbox padlets, and the full enumerated list of map_style ids with their light/dark classification. It also states the mutual exclusivity of wallpaper and wallpaper_image_url, which the schema does not enforce.

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?

States a specific verb (changes how a padlet looks) plus the exact resources it governs: color scheme, post size, font, wallpaper, and map style on map padlets. That enumeration clearly separates it from siblings such as update_padlet_layout or update_padlet_heading without the agent needing to open any schema.

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?

Gives concrete conditional rules: which font names apply to sandbox vs. non-sandbox padlets, 'Give wallpaper or wallpaper_image_url, not both', map_style instead of wallpaper on map padlets, and 'Pass only the settings that should change'. It never names an alternative sibling tool for layout/heading/sharing changes, so it stops short of a full when-to-use-vs-alternatives statement.

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.