Skip to main content
Glama
tokensqueezer-mcp

tokensqueezer-mcp

compare_selections

Compare the current Figma selection with the previous one to reveal token and node-count changes plus added or removed layer names.

Instructions

Compare the current Figma selection with the previous selection (token delta, node count delta, and added/removed layer names).

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "compare_selections"
  }
}

Input Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.4.1

TDQS

B3.3/5.0
Behavior2/5

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

With no annotations, the description carries the full behavioral burden. It is presumably a read-only, stateful comparison, but the description never says so, nor does it explain what happens on the first call when no previous selection exists, whether result history is retained, or how staleness of the 'previous selection' is handled. Disclosing the delta components is useful but leaves the stateful semantics opaque.

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?

A single front-loaded sentence with the comparison target first and the returned deltas in parentheses. Nothing is padded and nothing important 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?

For a zero-parameter tool with no output schema, the description does the necessary work of enumerating what the result contains (three delta categories). It is only slightly short of complete because it omits the stateful precondition and first-call behavior, which matter for an ambient-state comparison tool.

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

Parameters4/5

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

The tool takes zero parameters, so there is nothing for the description to disambiguate; the baseline of 4 applies. The description correctly implies the inputs are ambient session state (current and previous selections) rather than arguments.

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?

The description names a specific verb and resource ('Compare the current Figma selection with the previous selection') and enumerates the exact output dimensions (token delta, node count delta, added/removed layer names). An agent immediately knows what the tool does; the only gap is that it does not explicitly differentiate itself from siblings like get_design_tokens.

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, no statement of prerequisites (e.g., that a prior selection must exist in session state), and no reference to alternatives such as get_figma_context or search_layers for inspecting the current selection. The agent must infer the appropriate moment to call it from the name alone.

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