Skip to main content
Glama

Pick one option

ask_choice

Decide one multiple-choice question from supplied context and return the chosen option, confidence, probabilities, and uncertainty flag; if uncertain, ask the user before acting.

Instructions

Decide one multiple-choice question for the given context, e.g. 'How big is this work?' or 'What is the tone of this comment?'. Returns the chosen option, confidence, per-option probabilities, and 'uncertain'. When 'uncertain' is true, ask the user instead of acting.

Input Schema

NameRequiredDescriptionDefault
contextYesEverything needed to decide, as plain text or a JSON object. Examples: a GitHub issue (title, body, labels, comments), an email, a social media post, a support ticket, a document, the current state of a task.
optionsYesOption name -> what it means. At least 2.
questionYesThe question to decide, e.g. 'How big is this work?'
min_confidenceNoMark 'uncertain' when confidence is below this

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations, the description carries the full burden, and it delivers useful behavior: the return payload (chosen option, confidence, per-option probabilities, 'uncertain') and the escalation policy when uncertain. It does not disclose that this is a model-driven, potentially non-deterministic call whose confidence threshold is user-tunable.

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 sentences, front-loaded with the action and its scope, then examples, then return shape, then the escalation rule. No sentence is filler and nothing is buried.

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 no annotations and no output schema, the description compensates well by describing the return payload and the uncertain-handling path, which are the two things an agent most needs. The remaining gap is the absence of any guidance on choosing this tool over its siblings for a given decision.

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 all four parameters are already documented in the schema, including min_confidence's threshold semantics; baseline 3 applies. The description only indirectly reinforces 'context' via the example questions and adds what happens downstream of the uncertain flag rather than new per-parameter meaning.

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 and resource: 'Decide one multiple-choice question for the given context', backed by two concrete examples ('How big is this work?', 'What is the tone of this comment?'). The 'one multiple-choice question' framing also implicitly separates it from the binary ask_yes_no sibling and from the rule-evaluation siblings.

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 clear operating context plus an explicit conditional rule: when the 'uncertain' flag is true, ask the user instead of acting. It does not, however, say when to prefer this tool over ask_yes_no or evaluate_rules, so no true when-not/alternative routing is provided.

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