Skip to main content
Glama

Subtract an overlapping selection

bpj_sheet_subtract
Read-onlyIdempotent

Return up to four disjoint rectangles covering the first selection after removing the overlap.

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": {
      "range": "<range>",
      "other": "<other>"
    },
    "name": "bpj_sheet_subtract"
  }
}

Input Schema

NameRequiredDescriptionDefault
otherYes
rangeYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

B3/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds genuine behavioral detail beyond that — the result is capped at four rectangles and the pieces are disjoint — but leaves edge cases unexplained, such as behaviour when there is no overlap, when one range contains the other, or what order the rectangles are returned in.

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?

A single tightly written sentence with no filler, and the core result (up to four disjoint rectangles) is front-loaded. Its brevity is close to being under-specification rather than conciseness, but there is no wasted wording.

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

Completeness3/5

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

For a simple two-range geometry tool with no output schema, the description does state the return shape, which is the main thing an agent needs. However, the ambiguity over which argument is subtracted and the unstated no-overlap/containment behaviour leave meaningful gaps for correct invocation.

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

Parameters2/5

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

Schema description coverage is 0%, so the description must carry the burden, and it does not. It refers only to 'the first selection' and never clarifies which of the two A1-range parameters is the base and which is the subtrahend, nor does it explain the A1 notation or length constraints.

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 gives a specific verb-and-resource: returning disjoint rectangles covering the first selection after subtracting the overlap. This is recognizably a range-subtraction operation, distinguishable from geometric siblings like intersection or bounding-box tools, though it never names an alternative explicitly.

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 or when-not-to-use guidance, and no mention of alternatives such as an intersection or split tool. An agent must infer the use case purely from the geometric wording, and get no help deciding between this and neighbouring range operations.

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.