Skip to main content
Glama

Keep a presenter

keep_presenter

Keep one picture of a drawing as one of the team's presenters, with the voice the person chose for them. Answers the presenter's id, for presenters in the other tools. Free.

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": {
      "id": "<id>",
      "picture": "<picture>"
    },
    "name": "keep_presenter"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesThe id describe_presenter answered.
voiceNoA woman's voice or a man's voice, for an Arabic video whose voice is added after filming: the person's choice, which a picture does not tell.
pictureYesThe number of the picture to keep.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / voice / description
      Previous value: -"A woman's voice or a man's voice, which an Arabic video asks for: the person's choice, which a picture does not tell."New value: +"A woman's voice or a man's voice, for an Arabic video whose voice is added after filming: the person's choice, which a picture does not tell."
  2. First observed

TDQS

B3.4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=false, destructiveHint=false, and openWorldHint=false, so the write-but-non-destructive profile is covered structurally. The description adds a cost signal ('Free'), which is valuable context not present in annotations. It does not disclose whether keeping a picture replaces an existing presenter picture, whether there is a limit on presenters per team, or any auth/ownership requirements.

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 with no padding, and the core action is front-loaded. However, the second sentence is grammatically garbled ('Answers the presenter's id, for presenters in the other tools'), which costs clarity for a sentence meant to convey an important return-value contract.

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?

With only three fully-described parameters, no output schema, and clear annotations, the main gap is what the tool returns — and the description partially covers that by stating it answers the presenter's id for use in other tools. Remaining omissions (overwrite behavior, per-team limits) are minor for this complexity level.

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 100%, so every parameter is already documented in the input schema, establishing a baseline of 3. The description reinforces the voice concept ('with the voice the person chose for them') but adds no syntax, format, or constraint detail beyond what the schema already 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?

States a specific verb+resource: 'Keep one picture of a drawing as one of the team's presenters.' This is distinguishable from siblings like describe_presenter (lookup), list_presenters (enumerate), and set_presenter_voice (modify an existing one). The phrasing 'picture of a drawing' is slightly awkward but the operation is identifiable.

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?

'Answers the presenter's id, for presenters in the other tools' implies a chaining workflow (this tool's output feeds the other presenter tools), and 'Free' signals no credit cost, which matters given siblings like get_balance and quote_video. However, there is no explicit when-to-use vs when-not guidance, nor any statement about what happens if a presenter for that id already exists.

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.