Skip to main content
Glama

mcbaratone

A safety-gated autonomous Minecraft agent built around observable effects, resumable state, and explicit failure boundaries.

CI License: MIT Python 3.10+ Java 25

mcbaratone combines a Python controller, a Java/Fabric bridge, MCP and JSON-RPC interfaces, checkpointed planning, and evidence-driven tests. Its long-term goal is a no-cheat agent that can begin in a real Survival world, establish a sustainable base, reach and defeat the Ender Dragon, and continue into construction and terraforming without player intervention.

The complete spawn-to-endgame mission is not yet proven. The repository deliberately distinguishes implemented behavior, offline contract proof, bridge compilation, and observed in-world acceptance.

Why this project exists

Game automation makes distributed-systems failures unusually visible: a command can be accepted while the world never changes, a retry can duplicate an irreversible action, and a checkpoint can describe state that no longer exists. mcbaratone treats those as engineering problems rather than scripting edge cases.

The project emphasizes:

  • observed postconditions instead of command-success claims;

  • bounded retries and reconciliation for uncertain mutations;

  • resumable phase and objective state;

  • survival, identity, and world-safety gates;

  • transport-independent command and event contracts;

  • deterministic offline tests before any live-world exercise;

  • telemetry that separates dispatch, bridge response, completion, world effect, and durable progress.

Related MCP server: Minecraft Dedalus MCP

Architecture

flowchart LR
    P[Checkpointed planner] --> C[Python controller]
    C --> S[Safety and survival gates]
    S --> T[Transport abstraction]
    T -->|TCP / WebSocket / MCP| B[Java Fabric bridge]
    B --> R[Baritone + Minecraft]
    R --> E[Events and observations]
    E --> V[Postcondition verification]
    V --> P
    V --> O[Telemetry and dashboard]

See Architecture for the component and evidence boundaries.

Repository map

Path

Purpose

src/baritone_client/

Python transports, controller, state machines, safety logic, operations, MCP server, and HTTP API

bridge/

Java 25 Fabric bridge, command handlers, mutation ledger, event services, and bridge tests

tests/

Offline unit, contract, state-machine, recovery, and safety tests

tests/functional/

Explicitly selected live-world harnesses with destructive/read-only classifications

dashboard/

React/Vite operational dashboard frontend

actions/

Small reusable action facade

scripts/operations/

Bounded worker entry points retained as public examples

Verification snapshot

The publication candidate was validated on 12 September 2026:

  • Python: 2,338 passed, 1 skipped using the offline-default Pytest configuration;

  • secrets: complete retained Git history scanned with Gitleaks 8.30.1, 0 findings;

  • history: 627 commits retained after removing private operations material;

  • live-world tests remain excluded from the default Pytest command.

CI repeats the Python suite on Linux and Windows, builds and tests the Java bridge, and lints/builds the dashboard.

Quick start: offline development

python -m venv .venv

On Windows:

.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
.\.venv\Scripts\python.exe -m pytest -q

On Linux or macOS:

.venv/bin/python -m pip install -e '.[dev]'
.venv/bin/python -m pytest -q

The default Pytest configuration excludes tests marked live_readonly and live_mutating.

Build the bridge

The bridge targets Minecraft 26.2 and requires Java 25. Its pinned Baritone Fabric API dependency, exact upstream source reference, hash, and LGPL-3.0 notice are documented under bridge/libs/.

Set-Location bridge
.\gradlew.bat --no-daemon --console=plain build

On Linux or macOS, use ./gradlew --no-daemon --console=plain build.

The bridge has no authentication layer. Keep it on loopback or another explicitly trusted transport; do not expose it directly to the internet.

Functional-test safety

Functional tests connect to Minecraft and are not interchangeable with offline tests. Some suites teleport players, grant items, alter blocks, or reset disposable worlds. Read the functional test safety guide, list the available tests, and select one explicit test ID. Never run an unfiltered live suite against a valued world.

.\.venv\Scripts\python.exe tests\functional\run_tests.py --list

Public/private boundary

This public repository intentionally excludes deployment inventories, server addresses, current handoffs, world maps, checkpoints, telemetry captures, family-server configuration, and recovery state. Those are operational data, not source dependencies.

That boundary is part of the design: public core development should remain reproducible without access to a specific server or world.

Status

Implemented and exercised offline:

  • TCP, WebSocket, HTTP, and MCP-facing integration surfaces;

  • checkpointed autonomous phases and adaptive scheduling;

  • navigation, inventory, crafting, storage, combat, farming, and construction policies;

  • postcondition verification and uncertain-mutation reconciliation;

  • event correlation, mutation ledger, circuit breaker, and telemetry components;

  • React dashboard and Java/Fabric bridge builds.

Still requiring end-to-end evidence:

  • a complete organic no-cheat spawn-to-Ender-Dragon run;

  • durable post-dragon construction and terraforming over long runtimes;

  • recovery across every real-world crash and partial-mutation boundary.

License and trademarks

First-party source is available under the MIT License. Bundled third-party components retain their own licenses; see Third-party notices.

Minecraft is a trademark of Microsoft. Baritone is an independent open-source project. mcbaratone is not affiliated with or endorsed by Microsoft, Mojang Studios, or the Baritone maintainers.

Available Tools

69 tools
axisC

Go to an axis or diagonal axis.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.3/5.0
Behavior2/5

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

No annotations are provided, so the description carries full burden, yet it discloses almost nothing. It does not state whether this teleports, walks, sets an orientation, or requires a target, nor does it mention permissions, side effects, or failure modes. Given the zero-parameter schema and a navigation context with many similar siblings, this is a significant gap.

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?

The description is a single short sentence with no wasted words. However, brevity here results from under-specification rather than tight, front-loaded communication of a complex idea.

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

Completeness2/5

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

Although an output schema exists (so return values need not be described), the description omits critical context for a navigation tool in a crowded sibling space. Without annotations and with no explanation of what 'axis' means or how this differs from thisway, path, or goal_coordinates, an agent cannot reliably invoke it.

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 and the schema description coverage is 100%, so the baseline is 4. There are no parameters for the description to explain, and it correctly implies this is a parameterless navigation action.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Go to an axis or diagonal axis' restates the tool name with a vague verb and an undefined resource. In the context of Minecraft bot siblings like goto_block_type and goal_coordinates, 'axis' is ambiguous – it could mean a coordinate axis, an orientation, or a movement mode. No sibling is named to disambiguate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives such as thisway, path, goal_coordinates, or goto_block_type. The description provides no conditions, prerequisites, or exclusions, leaving an agent unable to choose between them.

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

batch_commandC

Execute multiple Baritone commands sequentially with proper error handling.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandsYes
stop_on_errorNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are supplied, so the description carries the full burden. 'Proper error handling' is undefined: it does not say whether execution halts on the first failure, whether already-run commands persist, whether it is cancellable, or whether a running Baritone instance is a prerequisite. The only behavioral hint is vague.

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 compact sentence with the verb and the batching scope front-loaded. No filler, though one clause spent on the vague 'proper error handling' delivers little information for its cost.

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

Completeness2/5

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

An output schema exists, so return values need not be explained, but for an execution/mutation tool with zero annotation coverage the definition omits prerequisites, failure semantics, ordering guarantees, and per-command validation rules. The delivery mechanism of the promised error handling is entirely left to the undocumented stop_on_error field.

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 compensate and does not: neither 'commands' (format of each command string, whether they share context/state) nor 'stop_on_error' (the parameter that actually governs the promised 'error handling') is named or explained. The phrase 'proper error handling' gestures at error policy but never ties it to the schema field that controls it.

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?

Specific verb (Execute) plus resource (Baritone commands) with the defining modifier 'multiple ... sequentially', which distinguishes it in kind from the single-command sibling run_command. It stops short of naming run_command or cancel_command as the alternatives, so the agent must infer the split from the plural noun alone.

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 explicit statement of when to use this instead of run_command, nor any exclusion (e.g. when a single command or a mission queue is more appropriate). Batching is merely implied by the word 'multiple', which is guidance by inference only.

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

blacklistB

Blacklist the closest block so Baritone won't attempt to get to it.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/5.0
Behavior3/5

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

No annotations are provided, so the description carries the burden. It explains the effect on Baritone's pathing, which is useful, but doesn't disclose scope (persistent vs session), whether it's reversible, or the proximity definition of 'closest'. A reasonable but incomplete behavioral picture.

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 short sentence with no waste, and the core action is front-loaded.

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?

An output schema exists, so return values needn't be explained. For a zero-param action tool with no annotations, the description covers the intent but leaves behavioral details (persistence, reversibility, selection scope) unstated.

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?

Zero parameters, so baseline 4 applies. The description implies the target is implicit ('closest block'), which is consistent with an empty schema and adds useful meaning.

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 ('Blacklist') and resource ('closest block'), and adds the actor context ('Baritone') and purpose ('won't attempt to get to it'). Distinct from siblings like set_goal_block or cache_block.

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?

No guidance on when to use this versus alternatives like clear_cache or set_setting. The purpose implies it's for excluding an obstructing block, but no explicit when/when-not conditions are given.

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

broadcast_mission_stateC

Broadcast mission state update to all subscribed MCP clients.

ParametersJSON Schema
NameRequiredDescriptionDefault
priorityNo
mission_dataYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.6/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 burden. 'Broadcast ... to all subscribed MCP clients' does disclose the fan-out side effect, which is the one genuinely useful behavioral hint, but there is nothing about permissions, delivery guarantees, failure behavior when no clients are subscribed, or idempotency.

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?

One tight, front-loaded sentence with no filler. It is well-structured, though the brevity here reflects under-specification rather than deliberate economy.

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

Completeness2/5

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

An output schema exists, so return values need not be explained. However, for a side-effecting broadcast with a free-form mission_data payload and no annotations, the description omits the payload contract and the runtime behavior an agent needs to invoke it correctly.

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

Parameters1/5

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

Schema description coverage is 0% for two parameters, one of which (mission_data) is an open-ended nested object with additionalProperties: true. The description adds no meaning for either mission_data or priority (including what the integer default of 0 implies), so it fails to compensate for the total coverage gap.

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 (Broadcast), resource (mission state update), and audience (all subscribed MCP clients), which is more than a restatement of the name. It does not, however, differentiate itself from siblings such as subscribe_mission_updates or mission_queue, whose relationship to this fan-out notification is left unstated.

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 guidance on when to call this rather than the sibling mission/subscription tools, nor any precondition (e.g., that clients must have subscribed first). The agent must infer usage entirely from the tool name.

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

build_open_schematicB

Build the schematic that is currently open in Schematica.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It only restates the build action and does not disclose side effects, destructive impact, permissions, prerequisites, or whether the operation consumes resources.

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 no filler or repetition. Every word contributes to identifying the action and its target.

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?

The output schema exists, so return values do not need explanation, and the zero-parameter schema is fully documented. However, for an unannotated build/mutation tool, the description leaves significant behavioral gaps, including how it relates to the sibling build_schematic.

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 has zero parameters and schema coverage is 100%, so there is no parameter semantics for the description to add. Baseline 4 is appropriate because the empty schema fully defines the invocation.

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 (Build) and resource (the schematic currently open in Schematica), so the agent knows the core action. It does not, however, distinguish this from the sibling build_schematic tool or clarify the relationship between an 'open' schematic and other schematic-building operations.

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?

Usage is implied by 'currently open in Schematica' – the tool applies when a schematic is open. There is no explicit when-to-use guidance, no when-not-to-use condition, and no named alternative such as build_schematic.

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

build_schematicC

Build a schematic. Optionally specify origin coordinates.

ParametersJSON Schema
NameRequiredDescriptionDefault
xYes
yYes
zYes
nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden and it does not meet it. "Build" implies a world mutation, but nothing is said about whether existing blocks are overwritten, what permissions or uploaded assets are required, or whether the operation can be undone.

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?

Two short sentences with no filler and the action stated first, but the brevity comes from omission rather than efficiency. It is under-specified rather than tight.

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

Completeness2/5

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

An output schema exists so return values need no prose, but for a mutation tool with zero annotation coverage, 0% parameter documentation, and a near-identical sibling the description is far too thin. Nothing tells the agent what the call actually needs or produces.

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% across four parameters, and the description never names the `name` parameter at all. Worse, it calls the origin coordinates "optional" while the schema marks x, y, and z as required, so the description actively misleads on requiredness rather than compensating for the coverage gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Build a schematic" gives a verb and a resource, so the basic action is legible, but it is nearly a restatement of the tool name and does nothing to separate it from the sibling build_open_schematic or from start_schematic_upload. An agent cannot tell which of these build paths applies without opening schemas.

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?

The only usage-adjacent information is "Optionally specify origin coordinates," which is parameter talk, not guidance. There is no statement of when to use this versus build_open_schematic, no prerequisite (e.g., a schematic must already be uploaded), and no exclusions.

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

cache_blockC

Cache block state information.

ParametersJSON Schema
NameRequiredDescriptionDefault
xYes
yYes
zYes
block_stateYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden, yet it discloses nothing about write/overwrite semantics, persistence, whether existing cached values are replaced, coordinate frame expectations, or permissions. 'Cache' weakly implies storage but leaves all operational behavior to inference.

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?

A single short, front-loaded sentence with no filler. However, the brevity reflects under-specification rather than efficient communication, since key operational details are omitted.

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

Completeness2/5

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

An output schema exists so return values need not be explained, but for a 4-parameter mutation tool with no annotations the description is far too thin. An agent lacks enough information to call it correctly regarding block_state format, overwrite behavior, and how it relates to get_cached_block.

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% and the description adds no meaning for any of the four required parameters. The names x, y, z, and block_state are somewhat self-explanatory, but the accepted format for block_state and the coordinate frame are undocumented in both the schema and the description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a verb and resource ('cache block state information'), but the verb is ambiguous – it does not clarify whether this stores state into a cache or retrieves cached state, which matters because the sibling get_cached_block exists. It is more specific than a tautology but gives no scope or differentiation from siblings.

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 guidance on when to use this tool versus get_cached_block or clear_cache, nor any prerequisites or conditions. The agent must infer usage entirely from the name and sibling list.

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

cancel_commandB

Cancel the active Baritone task.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It does not say what happens if no task is active, whether the cancel is idempotent, whether it is reversible, or what errors may occur. For a state-mutating control tool, this is a notable gap.

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 front-loaded sentence with no filler; verb and object come first. It is appropriately sized, though there is no additional structure because there is so little content.

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?

An output schema exists, so return values need not be explained, and there are no parameters to document. Given the low complexity, the description is nearly adequate, but with no annotations and no guidance on when to cancel versus using other task-control siblings, it leaves real gaps.

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 per the rubric the baseline is 4. There is nothing further for the description to clarify about inputs.

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 and resource: 'Cancel the active Baritone task.' This is clear enough to distinguish it from resource-specific siblings like cancel_upload or clear_goal. However, it does not explicitly differentiate itself from other task-control siblings such as stop_mining or clear_goal.

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 guidance on when to use this versus alternatives like clear_goal, stop_mining, or cancel_upload, nor any precondition (e.g., whether a task must be active). The agent must infer usage entirely from the name.

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

cancel_uploadD

Cancel an upload.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

D1.9/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full behavioral burden, and it discloses nothing: not whether the upload handle is freed server-side, whether partially transferred data is cleaned up, whether the operation is idempotent, or what happens on an already-completed upload. For a mutation tool with zero annotation coverage this is a critical gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The single sentence is front-loaded and waste-free, but it is under-specified rather than concise: the size is too small for a mutation tool with an undocumented required parameter and no annotations.

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

Completeness2/5

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

An output schema exists so return values need not be explained, but that is the only thing covered. With no annotations, an undocumented required parameter, and no statement of effects or preconditions, the definition is not complete enough to invoke the tool safely.

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

Parameters1/5

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

The single required parameter 'name' has 0% schema description coverage, and the description says nothing about it. It is unclear whether 'name' is the upload ID, a file name, or a job name, so the agent cannot supply it correctly from the description alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a clear verb+resource ('Cancel an upload'), which is better than a bare restatement of the name. However, it never identifies which upload subsystem this applies to, even though a sibling (start_schematic_upload, get_upload_progress) makes the target ambiguous, so an agent cannot confidently distinguish this from other cancellation tools like cancel_command.

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 and no mention of alternatives, despite cancel_command and stop_mining existing in the sibling set. The agent must infer the applicable conditions entirely on its own.

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

clear_cacheB

Clear all cached data.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral disclosure burden. It states the scope ('all cached data') but does not describe whether the operation is destructive, reversible, requires permissions, or affects persistent state.

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 short sentence with no wasted words. The purpose is front-loaded and immediately clear.

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 zero-parameter cache-clearing tool with an output schema, the description covers the basic action. However, it omits any behavioral detail about side effects or when to invoke it, leaving a noticeable gap given the absence of annotations.

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 no parameters, so there are no parameter semantics to document. The baseline for zero-parameter tools is 4.

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 and resource: 'clear' and 'all cached data.' It is immediately understandable, but does not distinguish this tool from related cache siblings such as get_cached_block or cache_block.

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?

Provides no guidance on when to use this tool versus alternatives. There is no mention of prerequisites, side effects, or situations where clearing the cache is appropriate or inappropriate.

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

clear_goalB

Clear the current pathing goal.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden, yet it says nothing about side effects: whether clearing stops in-progress movement, whether it is idempotent when no goal is set, or whether it is reversible. For a state mutation this is a meaningful gap.

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 zero filler, exactly sized for a no-argument command.

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?

The output schema means return values need not be described, and there are no parameters to document, but for an unannotated state-mutating tool the description should at least note the effect on active pathing. It is minimally adequate rather than complete.

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 the baseline is 4; there is no parameter syntax for the description to clarify, and it correctly adds no redundant detail.

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 ('Clear') and resource ('current pathing goal'), so the agent can tell this apart from set_goal_block or goal_coordinates in the navigation cluster. It is clear but does not explicitly name or contrast with the sibling tools it complements.

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 guidance on when to use this versus set_goal_block, path, or thisway, nor any prerequisite such as 'only call when a goal is active'. Usage must be inferred entirely from the name.

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

clickC

Click the destination on the screen (where player is looking).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.8/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure and falls short. It never says what a click actually does — break a block, interact with an entity, open a GUI, trigger a right/left click — nor whether it has side effects or requirements. For an action tool with zero annotation coverage this is a meaningful gap.

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 front-loaded sentence with no wasted words, but the brevity comes at the cost of under-specification rather than true economy. It reads cleanly and is easy to scan.

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

Completeness2/5

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

With no annotations and no parameters, the description is the only source for interaction semantics, and it only gestures at the target. An agent cannot tell what the click will affect or trigger, which is the key information needed to invoke this action safely.

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, and schema coverage is 100%, so there is nothing for the description to compensate for. Baseline 4 applies for a parameterless tool.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a verb (click) and a loose target ('the destination on the screen'), with the parenthetical clarifying it means where the player is looking. However, 'destination' is ambiguous — it could mean a block, a GUI element, or a coordinate — and nothing distinguishes this action from sibling movement/interaction tools like path, thisway, or goto_block_type.

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 guidance on when to use this tool, when not to, or what alternative to reach for. The agent gets no condition, prerequisite, or context for choosing 'click' over the many navigation/interaction siblings.

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

comeB

Tell Baritone to head towards your camera.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3/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 does not say whether this displaces an existing goal, whether it can be cancelled, whether Baritone must be running, or what state it changes — 'head towards' implies ongoing motion with no disclosure of side effects.

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?

One short, front-loaded sentence with no waste. It is efficient, though it leaves room for a clause that would have disambiguated it from sibling commands.

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

Completeness2/5

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

An output schema exists so return values need no explanation, but for an unannotated state-changing movement command the description omits prerequisites, interaction with other movement tools, and whether the goal persists or is cancellable.

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, and the description correctly implies the camera direction is the implicit input. Baseline 4 applies since there are no parameters to document.

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 concrete verb and object ('head towards your camera') for an otherwise opaque name like 'come'. It does not, however, distinguish itself from near-siblings such as 'thisway', 'follow_player', or 'goto_block_type', which an agent must infer are different.

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 statement of when to use this rather than 'thisway', 'follow_player', or 'path', nor any precondition such as Baritone being active. The agent is left to guess 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.

damnD

daniel

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

D1.6/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure, and it discloses nothing. Whether this mutates state, requires auth, or blocks is entirely unknown.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One word is not conciseness but under-specification; the text is not front-loaded because there is nothing to front-load. It fails the standard applied to similarly empty definitions.

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

Completeness1/5

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

Even though an output schema exists and reduces the need to explain return values, the description gives an agent zero basis to invoke the tool correctly. A name-only string is completely inadequate regardless of schema richness.

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, and the rules set a baseline of 4 when there are no parameters to document. There is nothing the description could add about inputs, though its silence on the output schema's contents is unhelpful.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description is the single word "daniel", which conveys no verb, resource, or purpose whatsoever. It does not distinguish this tool from any of the ~60 siblings, several of which also have opaque names.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no indication of when to use this tool, when not to, or which sibling it replaces. An agent has no basis to choose it over mine_quantity, eta, or any other sibling.

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

etaB

Get information about the estimated time until the next segment and the goal.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/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 implies a harmless read, but does not state whether it requires an active goal/path, what happens when none is set, or whether it blocks or polls. The only behavioral signal is the verb 'Get'.

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 tight sentence with the key information front-loaded ('Get information about the estimated time...'). No filler, but the brevity leaves the two domain terms unexplained.

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?

An output schema exists, so return values need no explanation, and there are no parameters to document. What remains missing is the precondition context — whether the tool is meaningful without an active goal or segment — which matters for a bot-state query 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 the baseline of 4 applies. There are no arguments whose meaning could be clarified, and the description's mention of 'segment' and 'goal' introduces no ambiguity at the parameter level.

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 clear verb+resource ('Get information about the estimated time') and names the two things it reports: time until the next segment and the goal. The terms 'segment' and 'goal' are domain-specific and undefined, but no sibling overlaps this function, so an agent can identify it.

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 indication of when to call this versus alternatives such as goal_coordinates, path, or proc, nor any prerequisite context (e.g. whether an active path or goal must exist). The description gives no usage conditions at all.

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

exploreC

Explore the world from the origin of x,z (or player feet if omitted).

ParametersJSON Schema
NameRequiredDescriptionDefault
xYes
zYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden. It doesn't disclose whether this is a read-only observation or a write/state-changing action, what happens during 'exploration' (movement? chunk loading? scanning?), whether it terminates, or any side effects. For a tool with a sibling set full of movement and mining commands, this is a significant gap.

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, short sentence with the core information front-loaded. It wastes no words, though brevity here borders on under-specification rather than true conciseness.

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

Completeness2/5

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

With an output schema present, return-value explanation isn't needed, but the description still fails to cover basic invocation semantics (required params vs. the 'if omitted' claim), behavioral nature (read vs. write, movement vs. inspection), or differentiation from many movement/search siblings. Incomplete for a tool in a densely populated namespace.

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% — the integer x,z parameters have no titles or descriptions in the schema. The description mentions 'the origin of x,z' and 'player feet if omitted', which hints at semantics, but this is contradicted by both parameters being marked required. An agent cannot determine coordinate conventions, allowed ranges, or nullability behavior.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a verb ('Explore') and a resource/domain ('the world from the origin of x,z'), which is clearer than a bare restatement of the name. However, it's vague about what 'explore' operationally means — no indication of whether it's a movement/wander behavior, a scanning operation, or a search. Against siblings like 'path', 'goto_block_type', and 'find', it's not sufficiently differentiated.

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 explicit guidance on when to use this tool versus alternatives like 'find', 'path', or 'goto_block_type'. The parenthetical 'or player feet if omitted' implies usage context but the required 'x','z' parameters (both required) contradict the 'if omitted' phrasing, leaving an agent confused about invocation conditions.

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

farmC

Automatically harvest, replant, or bone meal crops.

ParametersJSON Schema
NameRequiredDescriptionDefault
rangeYes
waypointYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description must carry the full behavioral burden. It states 'Automatically' but does not disclose what gets destroyed or changed, whether the action is reversible, what permissions are required, or any rate limits. For a mutation tool (harvest/replant), this is a significant gap.

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?

The description is a single, front-loaded sentence with no wasted words. It is concise, though its extreme brevity leaves critical information unaddressed in other dimensions.

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

Completeness1/5

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

Given two required parameters with zero schema description coverage, no annotations, and a mutation-style operation, the description is far too sparse to guide correct invocation. It omits any parameter explanation, behavioral context, or usage conditions.

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

Parameters1/5

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

Schema description coverage is 0%, and the description makes no mention of the two required parameters (range and waypoint). The agent has no information on what these parameters mean or how to supply them.

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 specific actions (harvest, replant, bone meal) and the resource (crops), which clearly communicates the tool's function. It does not differentiate from any sibling tool, but the verb+resource combination is unambiguous.

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?

The description provides no guidance on when to use this tool versus alternatives, nor does it state any preconditions or expected context. It only implies usage for farming without exclusions or routing information.

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

findC

Search through Baritone's cache and attempt to find the location of the block.

ParametersJSON Schema
NameRequiredDescriptionDefault
block_typeYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.8/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden. It does not disclose whether this is read-only, whether it can trigger movement/pathing, what happens when the block is not found, or how costly the search is. 'Attempt to find' faintly implies possible failure but nothing more.

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?

One short, front-loaded sentence with no filler. It is efficient, though its brevity is partly the source of the missing detail noted elsewhere.

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?

An output schema exists, so return values need not be explained. For a simple one-parameter read tool that is nearly adequate, but the absent parameter format and usage context (find vs. get_cached_block/goto) leave real gaps.

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 compensate and does not. It refers to 'the block' but never states the accepted format/namespace for block_type (e.g., 'minecraft:stone'), which is the key ambiguity for a single-parameter lookup tool.

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 states a specific verb+resource: it searches Baritone's cache for a block's location. That is meaningfully clearer than the bare name 'find'. It does not, however, distinguish this from siblings like get_cached_block, cache_block, or goto_block_type.

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 guidance on when to use this versus get_cached_block, goto_block_type, or path. No prerequisites, no conditions, no exclusions are given; the agent must infer the usage scenario entirely.

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

follow_entityB

Follow entities of a specific type (e.g. 'pig', 'cow').

ParametersJSON Schema
NameRequiredDescriptionDefault
entity_typeYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are provided, so the description carries full burden. It only states the action, with no details on follow behavior (continuous, distance, interruption), permissions, or side effects.

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 no filler. Appropriately sized for a simple action tool.

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?

An output schema exists, so return values need not be explained. With one required parameter and examples provided, the description is adequate for the basic call, but missing usage and behavioral context leaves gaps for an agent choosing between follow_entity and follow_player.

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 0%, so the description must compensate. It gives examples ('pig', 'cow') for entity_type, but does not specify format, case sensitivity, or valid values beyond those examples.

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 ('Follow') and resource ('entities of a specific type') with examples ('pig', 'cow'). This distinguishes it from sibling follow_player by focusing on entity types rather than a player, though it does not explicitly name the sibling.

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?

No when-to-use or when-not-to-use guidance. It does not mention alternatives like follow_player or any required conditions such as the entity being present or loaded.

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

follow_playerC

Follow a specific player.

ParametersJSON Schema
NameRequiredDescriptionDefault
player_nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden, yet it says nothing about how long the follow persists, whether it is interruptible, distance/stop behavior, permissions, or side effects on concurrent commands. Only the bare action is conveyed.

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 short sentence with the action front-loaded and no filler. It is efficient, though its brevity comes at the cost of the substance other dimensions need.

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

Completeness2/5

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

An output schema exists so return values need not be explained, but with no annotations, no parameter documentation, and no sibling differentiation against 'follow_entity', the definition is too thin for an action tool.

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 single 'player_name' parameter is undocumented anywhere. The description does not clarify whether the name must be exact, case-sensitive, or how it resolves against online vs offline players, so it fails to compensate for the schema gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('Follow a specific player'), so the action is clear in isolation. However, the sibling tool 'follow_entity' exists and the description makes no attempt to distinguish the two, leaving the agent to guess which to use when the target could be either.

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 guidance on when to use this over 'follow_entity' or any other movement sibling, and no exclusions or prerequisites. The description simply asserts what the tool does without saying under what conditions it applies.

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

gcB

Call System.gc() to free up memory.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/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, and it omits key traits: System.gc() is only a hint the JVM may ignore, and a full GC typically causes a noticeable pause. It says what it calls but not what actually happens or what side effects to expect.

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 twelve-word sentence that front-loads the action and states the goal, with no filler or redundancy. Nothing further could be trimmed without losing information.

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 zero-parameter tool with an output schema, the return value need not be explained, so basic coverage is met. However, with no annotations and no guidance that GC is a non-binding, potentially disruptive hint, the description is thinner than it should be for an operation agents might invoke repeatedly.

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 for a parameterless tool applies. No misleading claims about inputs are made.

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 and mechanism (invoke System.gc()) plus the intended outcome (free memory), so an agent knows exactly what the call does. It does not need sibling differentiation here since no other memory/GC tool exists in the list, but it also makes no attempt to distinguish itself from any.

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?

The phrase 'to free up memory' hints at intent but gives no explicit when-to-use or when-not-to-use guidance. There is no mention that this is a heavy stop-the-world operation that should be used sparingly, nor any prerequisites or recommended preconditions.

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

get_cached_blockC

Get cached block information at coordinates.

ParametersJSON Schema
NameRequiredDescriptionDefault
xYes
yYes
zYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.6/5.0
Behavior2/5

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

No annotations are provided, so the description carries full behavioral burden. It does not disclose what happens if the block is not cached, whether it returns null/stale data, or any cache-specific behavior (TTL, invalidation). 'Cached' hints at persistence but nothing more.

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 front-loaded sentence with no filler. Appropriately sized, though it is arguably too terse for the information it needs to convey.

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?

An output schema exists, so return-value explanation is not required, and the tool takes only 3 required primitives. However, with no annotations and no parameter documentation, the definition leaves key operational questions (cache miss behavior, coordinate frame) unanswered for an agent to call it confidently.

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% – x, y, z are only typed as integers with no explanation. The description confirms coordinates but doesn't add meaning (e.g., world/relative coordinates, valid ranges). With low coverage the description should compensate and does not.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (get) and resource (cached block) with a location qualifier (at coordinates). It's clear what it does, but offers no differentiation from siblings like cache_block or clear_cache, and the value of a 'cached block' versus a live lookup isn't explained.

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?

No when-to-use guidance, no mention of alternatives like cache_block or whether this requires the block to be cached first. An agent cannot tell from the description when this tool is preferable to other block/position queries.

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

get_command_analyticsC

Get performance analytics for a specific command.

ParametersJSON Schema
NameRequiredDescriptionDefault
command_nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It does not state whether this is read-only, whether it requires the command to have been run previously, what happens for an unknown command, or whether results are cached or real-time. For a read-analytics tool with zero annotation coverage, this is a notable disclosure gap.

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?

One short, front-loaded sentence with no filler. Efficient, though it borders on under-specification rather than true conciseness given the information gaps noted in other dimensions.

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?

An output schema exists, so return values need not be explained. However, with no annotations and no behavioral or usage context, the description is minimal for a tool that reads analytics data and has sibling tools in the same namespace. It is functional but leaves meaningful gaps an agent would need to discover by trial.

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 coverage is 0%, but there is only 1 parameter (command_name) which is fully required and self-explanatory as a field name. The description adds no detail about expected format (e.g., fully qualified name, case sensitivity, or identifier vs display name). With a single obvious parameter, this is adequate but not augmented.

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: 'Get performance analytics for a specific command.' This is clear about what the tool does and distinguishes it from sibling tools like get_performance_trends or get_system_health_alerts by scoping to a specific command. The meaning of 'analytics' itself is somewhat vague — an agent doesn't know what metrics are returned — but the purpose is unambiguous.

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?

No when-to-use guidance, no alternatives named, and no conditions for selecting this over get_performance_trends or other analytics siblings. The description stops at the purpose statement and leaves the agent to infer appropriate usage scenarios.

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

get_modified_settingsA

See all settings that have been modified from their default values.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.7/5.0
Behavior3/5

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

With no annotations, the description carries the full behavioral burden. 'See' implies a non-destructive read, but it does not state whether the call is safe/read-only, whether it is scoped to the user or system, or how results are ordered. For a zero-param read tool this is minimally adequate, not rich.

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 no filler; the scope constraint ('modified from their default values') is stated immediately and every word earns its place.

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?

An output schema exists, so return values need not be described, and the zero-parameter schema is fully documented. What remains unaddressed is minor behavioral context (read-only nature, scoping) rather than anything blocking correct invocation.

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 per the rubric the baseline is 4. There is nothing for the description to disambiguate, and the schema is trivially complete.

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?

Names a specific resource (settings modified from their defaults) and a clear read action ('See'), which distinguishes it from write siblings like set_setting and reset_setting. It does not, however, explicitly name or contrast itself with those siblings.

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?

The purpose implies the usage case (auditing which settings deviate from defaults), but there is no explicit when-to-use statement and no reference to alternatives such as reset_all_settings or set_setting. Usage is left to inference.

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

get_rate_limit_infoB

Get current rate limiting information.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden, yet it adds nothing beyond the name: it does not confirm this is a safe read-only operation, whether it counts against the limits it reports, or what dimension of limits (per-minute, per-tool, per-session) is returned. One clause of the description is doing all the work.

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 short sentence with no filler and the key information front-loaded. It is efficient, though so terse that it flirts with under-specification rather than being a model of tight, informative phrasing.

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?

The existence of an output schema means return values need not be described, which lowers the bar. However, with no annotations and a totally bare description, an agent gets no context on what the reported limits govern or when the information is actionable, leaving it only minimally complete.

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 parameter baseline of 4 applies. The empty schema is self-explanatory and no param-level detail is missing.

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 states a specific verb ('Get') and resource ('rate limiting information'), so an agent knows exactly what it retrieves. It doesn't need to distinguish itself from siblings here since none of the listed tools overlap with rate-limit reporting, but it also offers no scope (per-user, per-tool, global), which keeps it short of a 5.

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 guidance on when to call this versus alternatives, when it matters (e.g., before issuing batches of commands), or whether the call itself consumes quota. The only 'guidance' is the implied semantics of the tool name, which is not enough for a 3.

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

get_system_health_alertsA

Get current system health alerts and warnings.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.5/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full behavioral burden. 'Get' implies a non-mutating read and 'current' conveys temporal scope, but it says nothing about auth requirements, rate limits, or whether alerts are paginated or capped; the existence of an output schema relieves it of documenting return values.

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 clean sentence with the resource front-loaded and no filler. It is exactly as long as it needs to be.

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 getter whose output schema documents the return payload, the description covers what an agent needs to invoke it. The only missing piece is usage context relative to the other monitoring tools.

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. Baseline 4 applies.

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 ('Get') and resource ('current system health alerts and warnings'), so an agent knows exactly what it retrieves. It does not, however, distinguish itself from nearby siblings like get_rate_limit_info, get_performance_trends, or get_command_analytics, which are all monitoring-oriented.

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?

The description offers no when-to-use guidance, no prerequisites, and no named alternatives. An agent must infer that this is the tool to call when checking system status, with nothing routing it away from the related monitoring siblings.

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

get_upload_progressC

Get progress of an upload.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.6/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 burden of behavioral disclosure but offers almost nothing beyond the name. It implies a read-only check but does not mention permissions, rate limits, polling behavior, or what happens if the upload is missing.

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?

The description is a single, front-loaded sentence with no wasted words. It is appropriately sized for a simple tool, though it is arguably too terse to be fully helpful.

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

Completeness2/5

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

An output schema exists, so return values need not be explained. However, for a progress-checking tool, the description omits essential context such as what the 'name' parameter identifies and whether the check is synchronous or requires polling, leaving the agent under-informed.

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

Parameters1/5

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

The single required parameter 'name' has 0% schema description coverage, and the description does nothing to clarify what 'name' refers to (e.g., upload job name, file name, or identifier). The description fails to compensate for the missing schema documentation.

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 states a specific verb ('Get') and resource ('progress of an upload'), making the tool's function immediately clear. It does not, however, differentiate this tool from any sibling or alternative, so it misses the top score.

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?

The description provides no guidance on when to use this tool versus alternatives, nor does it mention prerequisites or conditions. It only restates the tool's purpose, leaving usage entirely to inference from the name.

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

goal_coordinatesC

Set a goal to the specified coordinates. Provide at least one coordinate.

ParametersJSON Schema
NameRequiredDescriptionDefault
xYes
yYes
zYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.6/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden. It says 'set a goal' but never discloses whether this moves the agent, replaces an existing goal, requires a navigation routine, or is reversible. For a state-mutating tool with zero annotation coverage, this is a significant gap.

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?

Two short, front-loaded sentences with no wasted wording. Brevity here works against completeness but not against structure.

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

Completeness2/5

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

A state-changing tool with three undocumented parameters, no annotations, and siblings that cover similar goal-setting territory. The description omits units/frame, the effect on an existing goal, and any routing guidance; the presence of an output schema excuses it only from describing return values.

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 0% and x/y/z are entirely undocumented in the schema. The description does add one useful clarification: because all three are required-but-nullable, 'provide at least one coordinate' explains that nulls are permitted and at least one axis must be non-null. However, it gives no units, coordinate frame, or axis meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a recognizable verb+resource ('set a goal to the specified coordinates'), but 'goal' is left undefined in a sibling set that already contains wp_goal, set_goal_block, and clear_goal. An agent cannot tell from the description how this goal differs from those, so it is vague rather than distinguishing.

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?

'Provide at least one coordinate' is a parameter constraint, not usage guidance. There is no statement of when to use this instead of wp_goal, set_goal_block, or clear_goal, nor any prerequisite (e.g., whether a path must exist or the agent must be idle).

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

goto_block_typeC

Go to a block of a specific type (e.g. 'diamond_ore', 'portal', 'ender_chest').

ParametersJSON Schema
NameRequiredDescriptionDefault
block_typeYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden. It does not disclose search radius, whether it blocks until arrival, what happens if the block is not found, or any permission/context requirements. For a movement command with zero annotation coverage this is a substantial gap.

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?

One front-loaded sentence with zero padding; the core action and an example are stated immediately. It is efficient, though the single sentence is thin for the amount of behavioral context the tool needs.

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

Completeness2/5

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

With no annotations, one undocumented parameter, and a movement-oriented action, the description should at least hint at scope (search range, failure behavior). The existence of an output schema removes the need to explain return values, but the remaining behavioral gaps leave the agent under-informed.

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 coverage is 0%, so the description must compensate, and the parenthetical examples ('diamond_ore', 'portal', 'ender_chest') do clarify the expected block_type values. But it gives no format rules (namespace, casing, variants) or mention that values must match in-game block IDs, so compensation is partial.

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 ('Go to') and resource ('a block of a specific type') with concrete examples, so the agent knows this is a navigation-to-block command. However, it does not distinguish itself from sibling navigation/search tools such as find, path, thisway, or goal_coordinates, leaving the agent to infer the boundary.

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 and no mention of alternatives. With siblings like find (likely block lookup) and path/goal_coordinates (movement), the agent gets no signal about when this tool is preferable to those.

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

help_commandC

Get help for Baritone commands.

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.8/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It does not disclose that this is a read-only/query operation, whether the required query can be null, what error behavior occurs, or how results are scoped — none of which the structured fields cover.

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 short, front-loaded sentence with no wasted words. It is efficient, though its brevity is more under-specification than disciplined conciseness.

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?

An output schema exists, so return values need not be explained. But for a tool with an undocumented required parameter and zero annotations, the description is too thin to cover usage and parameter semantics adequately.

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% for the single required 'query' parameter, and the description adds no meaning about its expected format (command name? keyword? free text?) or why the schema marks it required yet nullable. It only weakly implies the query targets a command name.

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 ('Get help') and resource ('Baritone commands'), so the purpose is unambiguous. However, it offers no differentiation from the sibling tool 'minecraft_help', leaving the agent to guess which help surface applies.

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 guidance on when to use this tool versus alternatives, no mention of prerequisites, and no indication of what happens with an empty or null query. Usage must be entirely inferred.

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

inspect_build_siteB

Inspect a build site candidate by radius before any mutation.

ParametersJSON Schema
NameRequiredDescriptionDefault
radiusYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full burden. It does signal that this is a read-only pre-mutation check, which is meaningful safety context, but says nothing about what the inspection reports, any limits, or failure behavior. With an output schema present, return values needn't be described, keeping this at a middling 3.

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, front-loaded sentence with no wasted words. It is efficient, though the terse phrasing borders on cryptic rather than fully informative.

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?

The output schema covers return values and there is only one simple parameter, so the burden is low. Still, the description never clarifies what a 'build site candidate' is or what the radius measures, which for a solo-purpose tool leaves a small but real gap.

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?

One required parameter with 0% schema description coverage, so the description must compensate. 'By radius' only loosely maps to the radius argument and gives no units, format, or meaning for what the radius bounds.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a verb (inspect) and a resource (build site candidate) scoped by radius, which is more specific than a tautology. However, 'inspect' is left undefined and no sibling is distinguished (e.g. preview_build_plan), so an agent cannot tell exactly what this check covers versus related tools.

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?

The phrase 'before any mutation' implies a precondition/timing for use, which is useful guidance. But it names no alternative tool and gives no explicit when-not condition, leaving the routing decision largely implied.

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

invertA

Invert the current goal and path (run away from goal).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

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

With no annotations, the description carries the full burden and does disclose the core behavioral trait: both the goal and the path are mutated, and the direction is reversed. It is silent on reversibility (does a second call restore the original goal?), persistence, and any permissions, which are real gaps for a state-mutating tool.

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?

One short sentence with the action front-loaded and the clarifying gloss right behind it. No filler, no redundancy.

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?

The output schema covers return values and there are no parameters to document, so the remaining need is behavioral. For a mutation of world navigation state with no annotations, the description is thin on reversibility and side effects, which leaves a gap an agent could hit.

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.

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 (invert) and its resources (goal and path), with a parenthetical that disambiguates the intent as running away from the goal. This is clear enough that an agent understands the effect without opening anything else, though it does not distinguish itself from goal/path siblings such as 'thisway' or 'goal_coordinates'.

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?

The parenthetical 'run away from goal' implies the situation in which it applies, but there is no explicit when/when-not guidance and no named alternative (e.g., 'thisway' or 'clear_goal') for when the agent wants a different kind of goal change. Usage must be inferred.

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

minecraft_describe_toolC

Return stable guidance metadata for the selected MCP tool.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. 'Return' weakly implies a read-only operation, but the description does not disclose permissions, side effects, stability guarantees, or error behavior for invalid tool names.

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?

The description is a single front-loaded sentence with no wasted wording. It is concise, though its brevity contributes to the ambiguity noted in other dimensions.

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

Completeness2/5

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

An output schema exists, so return values need not be described. However, for a one-parameter meta tool with no annotations and 0% schema description coverage, the description is too thin: it lacks usage routing, parameter detail, and behavioral context an agent needs to invoke it confidently.

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% for the single required 'name' parameter. The description adds only that it refers to the selected MCP tool, without clarifying format, valid values, or whether it must match a sibling tool name exactly.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a verb (Return) and a resource (guidance metadata) scoped to a selected MCP tool, so the broad purpose is identifiable. However, 'stable guidance metadata' is vague and the description does not distinguish this tool from sibling help/describe tools such as minecraft_help or help_command.

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 explicit guidance on when to use this tool versus alternatives. The phrase 'for the selected MCP tool' implies that a tool name must be supplied, but it does not say when an agent should call this instead of other help or metadata tools.

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

minecraft_helpC

Return static, read-only guidance for MCP agents.

ParametersJSON Schema
NameRequiredDescriptionDefault
taskNo
topicNoworkflow

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior3/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 does disclose two useful traits: the content is static and read-only, so the agent knows there are no side effects. However, it says nothing about auth requirements, rate limits, or how the task/topic inputs shape behavior, leaving significant gaps.

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 front-loaded sentence with no filler. It is efficient, though its brevity borders on under-specification rather than tight conciseness.

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

Completeness2/5

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

An output schema exists, so return values need not be explained, but the tool has two undocumented parameters and no usage guidance or annotation coverage. For a help tool whose whole value is telling an agent what to do, this description is too thin.

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 schema does not document either parameter, and the description never mentions task or topic. The agent is left to infer that topic defaults to a workflow string and that task is an optional free-form hint, with no semantics added anywhere.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a verb ("Return") and a resource ("guidance"), but "guidance" is vague about what the guidance covers and how it relates to the minecraft domain. It does not distinguish itself from the sibling help_command, leaving the agent unsure which to pick. Adequate but underspecified.

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?

No indication of when to use this versus alternatives, and the sibling set contains a plausible duplicate (help_command) plus minecraft_describe_tool. There is no exclusions, prerequisites, or context cue of any kind.

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

mine_quantityC

Mine a specific quantity of a block type.

ParametersJSON Schema
NameRequiredDescriptionDefault
quantityYes
block_typeYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.6/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden and delivers almost nothing: it does not say whether the call blocks until completion, whether it requires the agent to already be positioned at the target blocks, what happens if fewer blocks exist than requested, or whether it can fail or time out.

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?

A single front-loaded sentence with no filler, which is structurally clean. Against a tool with zero annotation coverage and fully undocumented parameters, however, this level of brevity reads as under-specification rather than genuine conciseness.

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

Completeness2/5

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

An output schema exists, so return values need not be described. Everything else is missing, though: no annotations, 0% parameter documentation, and no behavioral context for a world-mutating action, leaving the agent unable to call this confidently.

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 compensate for both parameters. It only echoes them implicitly — 'quantity' and 'block type' — without specifying the identifier format (e.g. namespaced block IDs), whether quantity is a hard upper bound, or valid ranges.

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 states a specific verb ('mine') and object ('a specific quantity of a block type'), so the core action is unambiguous. However, it offers no differentiation from adjacent siblings such as start_mining, goto_block_type, or item-production tools, leaving the agent to guess which mining entry point applies.

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 exclusions, and no named alternative. With siblings like start_mining, stop_mining, and goto_block_type in the same domain, the agent has no signal about when this bounded-quantity tool is preferable to a continuous mining session.

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

mission_checkpointC

Persist the active phase/checkpoint on the bridge.

ParametersJSON Schema
NameRequiredDescriptionDefault
noteNo
phaseYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.1/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. 'Persist' implies a write or state-saving operation, but there is no disclosure of whether it overwrites existing checkpoints, requires specific permissions, is idempotent, or has other side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single short sentence, which is concise, but it is under-specified rather than efficiently concise. It omits essential context that a tool with two undocumented parameters and no annotations needs.

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

Completeness2/5

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

Although an output schema exists and need not be explained in the description, this definition remains incomplete for a state-persisting tool. With no annotations, 0% schema description coverage, and many sibling tools, the description should clarify behavior, parameter roles, and when to use it.

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

Parameters1/5

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

Schema description coverage is 0% for both parameters. The description loosely references 'phase' via 'active phase/checkpoint' but gives no format, required status, or meaning for the 'note' parameter, so it does not compensate for the schema gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific action, 'Persist,' and an object, 'the active phase/checkpoint,' so the basic purpose is inferable. However, 'on the bridge' is opaque, and the description does not distinguish this tool from siblings like mission_macro, mission_queue, or broadcast_mission_state.

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?

No guidance is given on when to use this tool versus related mission/state tools, nor are prerequisites or exclusions stated. The description provides only a bare purpose statement with no invocation context.

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

mission_macroC

Invoke a mission macro or consume the queued macros (dequeue=True).

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes
paramsNo
dequeueNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden. It does disclose the dual behavior of invoking versus dequeuing, which is useful, but says nothing about side effects, authorization, async execution, whether macros mutate mission state, or what dequeue consumes.

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 compact sentence with the alternate mode placed last, so nothing is wasted. It is arguably too terse for the burden it must carry, but structure itself is clean.

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

Completeness2/5

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

With no annotations, 0% parameter coverage, and sibling tools like mission_queue left unaddressed, the description omits too much for a 3-parameter mission-control tool. The existing output schema excuses it from explaining return values, but little else.

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% across 3 parameters. The description clarifies the meaning of dequeue=True, adding genuine value, but leaves 'name' (required) and 'params' entirely unexplained, including how name interacts with the dequeue mode.

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 (invoke) and resource (mission macro), plus a second mode (consume queued macros). It does not differentiate itself from sibling tools like mission_queue or mission_checkpoint, but the core action is unambiguous.

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?

The only guidance is the inline hint '(dequeue=True)', with no explanation of when to invoke a named macro versus consuming the queue, and no mention of the related mission_queue sibling. An agent must guess the selection criteria.

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

mission_queueC

Queue mission macros that the bridge should execute sequentially.

ParametersJSON Schema
NameRequiredDescriptionDefault
clearNo
actionsYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It discloses sequential execution, which is useful, but omits critical details such as whether queuing replaces existing missions, what the 'clear' flag does, error handling, or permission requirements.

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?

The description is a single, front-loaded sentence with no filler. Every word contributes to stating the action and the execution model.

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

Completeness2/5

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

Although an output schema exists and need not be explained, the description is incomplete for a two-parameter queue tool with no annotations and zero schema descriptions. It lacks usage context, parameter meaning, and behavioral details about clearing or replacing queues.

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

Parameters1/5

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

Schema description coverage is 0%, and the description only vaguely implies that 'mission macros' correspond to the required 'actions' parameter. It says nothing about the 'clear' boolean, leaving both parameters undocumented in schema and description.

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 uses a specific verb ('Queue') and resource ('mission macros'), and states the scope of sequential execution by the bridge. It is clear what the tool does, but it does not distinguish itself from siblings such as mission_macro or mission_checkpoint.

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?

The description gives no guidance on when to use this tool versus alternatives. It does not mention mission_macro, batch_command, or other related tools, nor does it state prerequisites or exclusions.

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

pathC

Start pathing to the current goal.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.3/5.0
Behavior2/5

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

No annotations are provided, so the description carries full behavioral burden. It does not state whether the operation is blocking, asynchronous, cancellable, or what state it affects. With an output schema present, some return information is covered elsewhere, but the description should still indicate the nature of the operation (e.g., starts a background process, may be interrupted).

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?

The description is a single short sentence with no waste. It is front-loaded but under-specified rather than concise; still, it avoids unnecessary verbosity.

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

Completeness2/5

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

Given the complexity of navigation tools and the rich sibling set, the description is far too sparse. It doesn't explain what "current goal" refers to, how the goal is set, whether pathing is continuous or one-shot, or how to stop it. The output schema may cover returns, but the description leaves critical invocation context missing.

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?

There are zero parameters, so the baseline is 4. No parameter documentation is needed or missing.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Start pathing to the current goal' is essentially a tautology of the tool name 'path'. It restates the verb without specifying what entity paths, how it interacts with the goal system, or what environment it operates in. It is marginally clearer than the bare name but provides no distinguishing detail from siblings like 'goto_block_type' or 'thisway'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives. No prerequisites, no conditions, no exclusions. The sibling list includes many navigation tools (thisway, goal_coordinates, goto_block_type, follow_entity), yet the description offers no differentiation or routing information.

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

poll_eventsC

Poll events from the EventManager buffer.

ParametersJSON Schema
NameRequiredDescriptionDefault
max_eventsNo
event_typesNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It says events are polled from a buffer but does not disclose whether polling consumes events, blocks, returns immediately, respects ordering, or interacts with subscriptions. The presence of an output schema reduces the need to describe return values, but core polling semantics remain unexplained.

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 no wasted words. It states the action and source immediately.

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

Completeness2/5

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

For a tool with two undocumented parameters, no annotations, and sibling event-management tools, the definition is too sparse. The output schema covers return values, but the description should explain polling behavior, parameter effects, and relationship to subscribe/unsubscribe tools.

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

Parameters1/5

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

Schema description coverage is 0%, and the description adds no meaning for max_events or event_types. The parameter names are somewhat intuitive, but the definition provides no filtering, limit, or format semantics beyond the raw schema.

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 and resource: polling events from the EventManager buffer. It is clear what the tool does, though it does not differentiate itself from sibling event tools such as subscribe_events or unsubscribe_events.

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?

Provides no guidance on when to use polling versus subscribing, nor any prerequisites or alternatives. The purpose implies usage, but the agent must infer all selection criteria.

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

preview_build_planB

Generate a deterministic build-plan preview without bridge connection.

ParametersJSON Schema
NameRequiredDescriptionDefault
build_planYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior3/5

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

With no annotations provided, the description carries the full behavioral burden. It does disclose two useful traits—determinism and no bridge connection—which suggest a safe, offline preview. However, it does not state whether the operation is read-only, what permissions are needed, or whether any state is modified.

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?

The description is a single, front-loaded sentence with no redundant or filler language. It is appropriately sized for the tool's apparent simplicity.

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

Completeness2/5

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

The output schema exists, so return values need not be described. But the tool has no annotations, complete parameter documentation gaps, and the description provides no parameter semantics or safety details beyond determinism and offline use. For a tool with one undocumented required parameter and no annotations, the description is insufficiently complete.

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

Parameters1/5

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

Schema description coverage is 0% for the single required parameter 'build_plan'. The description does not mention the parameter, its expected format, or how to supply it. It fails to compensate for the complete absence of schema-level parameter documentation.

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 states a specific verb (Generate) and resource (build-plan preview) with a key qualifier (deterministic, without bridge connection). It is clear what the tool does, but it does not explicitly differentiate itself from similar build-related siblings like build_schematic or inspect_build_site.

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?

The phrase 'without bridge connection' implies a usage context (offline/preview scenarios), but there is no explicit when-to-use statement, no alternatives named, and no exclusions. Usage is left to inference from the stated constraint.

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

procB

View miscellaneous information about the process currently controlling Baritone.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.3/5.0
Behavior2/5

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

No annotations provided, so the description carries the full burden. It implies a read-only inspection but doesn't state whether it's safe, side-effect-free, or if the process must be running. No behavioral context beyond the basic read implication.

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, efficient sentence with no waste. Front-loaded with the action and resource. Appropriately sized for a simple inspection tool.

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?

Given the tool has no parameters and an output schema exists, the description needn't explain return values. However, it could clarify what 'process currently controlling Baritone' means and whether it requires an active process. For a zero-param read tool with output schema, the description is largely sufficient.

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?

Zero parameters, so no parameter semantics are needed. Baseline 4 is appropriate for a no-param tool. The description doesn't need to explain inputs.

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 (View) and resource (miscellaneous information about the process controlling Baritone). Clear enough to distinguish from siblings like version or get_system_health_alerts, though 'miscellaneous information' is somewhat vague about what data is actually returned.

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?

No guidance on when to use this tool versus alternatives. No mention of when-not-to-use or related tools. The agent must infer its purpose from the name and description alone.

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

read_fileC

Read the contents of a file.

ParametersJSON Schema
NameRequiredDescriptionDefault
file_pathYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.6/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 and does not meet it. It does not disclose whether reads require permissions, how large or binary files are handled, whether the file must exist, or what errors look like on missing/inaccessible paths.

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?

The single sentence is front-loaded and wastes no words, but its brevity comes from under-specification rather than efficient communication. It is neither bloated nor helpful beyond the tool title.

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

Completeness2/5

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

An output schema exists, so return values need not be explained, but for a file-reading tool the description still omits critical context: path resolution rules, size/encoding limits, and failure modes. It is too thin to guide correct invocation on its own.

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% and there is a single required parameter, file_path, whose meaning the description never elaborates. It does not clarify path format (absolute/relative), root/workspace constraints, or encoding, so it adds nothing beyond the bare schema.

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 states a specific verb ('Read') and resource ('contents of a file'), so the core operation is unambiguous. It does not, however, differentiate from any sibling or indicate scope (single file, local vs remote path namespace).

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 indication of when to use this tool, when not to, or what alternatives exist. Given the large sibling list, some routing guidance (e.g. versus a file-listing or search tool) would be valuable, but none is offered.

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

reload_allB

Reload Baritone's world cache.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It does not disclose whether reloading is safe or destructive, whether it blocks, what permissions are needed, or how it affects persisted data. Only the bare action is stated.

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 sentence with no wasted words, and the action is front-loaded. It is appropriately sized for a zero-parameter tool.

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?

Given the many cache and save/clear siblings, the description should clarify when to reload versus clear, cache, or save. With no annotations and no usage guidance, the definition is minimally viable but has clear gaps in helping an agent choose this tool correctly.

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 has zero parameters, so there are no parameter semantics to clarify. Per the baseline for zero-parameter tools, a 4 is appropriate; the description need not add anything here.

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 ('reload') and resource ('Baritone's world cache'), making the action clear. However, it does not differentiate this tool from cache-related siblings like clear_cache, cache_block, or save_all, leaving the agent to infer the distinction.

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?

The description provides no guidance on when to use this tool versus alternatives or what prerequisites exist. There is no when-to-use, when-not-to-use, or named alternative, leaving the agent without routing information.

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

renderC

Fix glitched chunk rendering.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.8/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It implies a mutation ('fix') but does not state whether it modifies world/save state, requires elevated permissions, invalidates caches, or is safe to call repeatedly. None of the side-effect profile is disclosed.

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 short sentence with no filler, and the operative action is front-loaded. It is appropriately sized, though the terseness contributes to the purpose ambiguity rather than resolving it.

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

Completeness2/5

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

With no annotations and no parameter documentation, the description is the only source of behavioral information, and it provides none. The existence of an output schema excuses not describing return values, but scope, side effects, and usage context are all missing.

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 and the schema is empty, so there is nothing for the description to document; the baseline for a parameterless tool applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a verb ('Fix') and a resource ('glitched chunk rendering'), which is more than a tautology of the name 'render'. However, it is ambiguous whether the tool renders, repairs, or refreshes chunk data, and it does not distinguish itself from rendering-adjacent siblings such as preview_build_plan or snapshot. Purpose is implied but not sharply defined.

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 prerequisites, and no mention of any alternative tool among the many siblings. The agent is left to infer that this is for visual glitches only.

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

repackB

Re-cache the chunks around you.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It says re-caching happens but does not disclose side effects, whether cached data is invalidated, performance cost, or safety characteristics.

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?

The description is one short, front-loaded sentence with no filler. It is appropriately terse for a zero-parameter tool, though its brevity also reduces helpful context.

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

Completeness2/5

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

An output schema exists and the tool is low complexity, so return values need not be explained. However, with no annotations and no usage guidance, the description does not give an agent enough context to choose this tool over sibling cache/reload tools.

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 has zero parameters and schema coverage is 100% via an empty object. Baseline for no parameters is 4, and there is no parameter meaning for the description to add.

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 pair: re-cache chunks around the player. It does not distinguish this operation from sibling cache tools such as clear_cache, cache_block, or reload_all, so it is clear but lacks sibling differentiation.

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?

The description gives no when-to-use guidance, prerequisites, or alternatives. An agent cannot tell whether to call repack instead of clear_cache, reload_all, or other cache-related siblings.

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

reset_all_settingsB

Reset all settings to their default values.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. For a bulk mutation that overwrites every setting, it fails to disclose that user customizations are discarded, whether the action is reversible, whether it requires elevated permissions, or whether any scope (global vs per-workspace) applies.

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 short sentence with the verb and scope front-loaded and no wasted words – appropriately sized for a parameterless operation.

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

Completeness2/5

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

An output schema exists, so return values need not be explained. However, for a destructive, no-annotation bulk operation, the description omits the impact and reversibility information an agent needs to call it safely.

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 to document; the baseline for a parameterless tool is 4. The description correctly implies no inputs are needed.

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 ('Reset') and resource ('all settings') with the scope explicitly quantified as 'all,' which implies a bulk operation. It does not, however, distinguish itself from the very close sibling reset_setting (singular) or set_setting/get_modified_settings, so an agent must infer the all-vs-one distinction.

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 guidance on when to use this versus reset_setting (which resets a single setting) or get_modified_settings. No mention of prerequisites, confirmation needs, or the conditions under which a bulk reset is appropriate.

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

reset_settingC

Reset a specific setting to its default value.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries full behavioral burden. It states the effect (reset to default) but omits whether the operation is idempotent, reversible, permission-gated, or what happens if the setting name is invalid.

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?

One sentence with zero waste, front-loading the action and target. It is appropriately sized for a simple reset tool.

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

Completeness2/5

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

Given no annotations, 0% parameter schema coverage, and multiple sibling settings tools, the description is too thin. It lacks parameter meaning, usage context, and behavioral details, though the output schema covers return values.

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

Parameters1/5

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

Schema description coverage is 0% for the single required parameter 'name'. The description says 'a specific setting' but adds no format, naming convention, or valid value guidance beyond what the parameter name already implies.

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 'reset' and resource 'setting' with the target 'default value'. It distinguishes from 'set_setting' by implying restoration, but does not explicitly differentiate from sibling 'reset_all_settings' or clarify scope beyond 'specific'.

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?

No guidance on when to use this tool versus alternatives like 'reset_all_settings' or 'set_setting'. The phrase 'a specific setting' implies single-setting scope but offers no explicit conditions, exclusions, or prerequisites.

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

run_commandC

Execute a raw Baritone/mission command string.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden and it does not disclose side effects, required permissions, whether execution is synchronous or queued, or the risk profile of an arbitrary command executor. Only the output schema exists to cover return values; behavior is essentially undocumented.

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 short sentence with no filler and the action front-loaded. It is efficient, though its brevity contributes to the specification gaps noted elsewhere.

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

Completeness2/5

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

With an output schema present, return values need not be described, but for a command-execution tool with no annotations and zero parameter documentation, the description leaves the agent unable to determine valid inputs, side effects, or how it differs from batch_command and mission_queue.

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 coverage is 0% on the single 'command' parameter, so the description must compensate. 'Raw Baritone/mission command string' does hint at the accepted format family, which is better than nothing, but no syntax, valid command names, or examples are provided.

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 concrete verb ('Execute') and resource ('raw Baritone/mission command string'), which is more specific than a tautology. It only weakly distinguishes itself from siblings like batch_command or mission_queue, but the 'raw command string' framing does signal a low-level escape hatch.

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?

No when-to-use guidance is given, and no alternative is named despite obvious candidates in the sibling list (batch_command for multiple commands, cancel_command for stopping, mission_queue for deferred execution). The agent must infer the intended context entirely.

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

save_allC

Save Baritone's world cache.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.3/5.0
Behavior2/5

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

No annotations are provided, so the description must disclose behavioral traits. It states a save operation, implying a mutation, but doesn't say whether it's a persistent disk write, what data is included, whether it's safe to call repeatedly, or what the output contains. The single sentence leaves almost all behavior opaque.

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?

The description is a single short sentence, which is appropriately concise. It's front-loaded with the action and object. However, the extreme brevity comes at the cost of usefulness, but on pure conciseness it's efficient with no filler.

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

Completeness2/5

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

Given that this is a zero-parameter tool with an output schema, the description should at least explain what 'world cache' encompasses and the effect of saving it. It doesn't. There's no indication of when to call it relative to other cache tools. The output schema exists, so return values are covered, but the operation's scope and side effects are not.

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 are no parameter semantics to describe. Per the rubric, zero parameters gets a baseline of 4. The description doesn't need to explain arguments, and none are missing.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Save Baritone's world cache' is essentially a restatement of the tool name save_all combined with a vague notion of 'world cache'. It does not clarify what specifically is saved (location data? chunk cache? build state?) or distinguish this from sibling reload_all or clear_cache. Without more detail, it's nearly tautological.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance whatsoever on when to use this tool. The description does not explain when to call save_all versus reload_all or other cache-related siblings like get_cached_block or cache_block. An agent would have no basis for selecting this tool over others.

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

set_goal_blockB

Apply a block-level navigation goal using goto command (bridge doesn't support GoalBlock).

ParametersJSON Schema
NameRequiredDescriptionDefault
xYes
yYes
zYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior3/5

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

With no annotations, the description carries the full behavioral burden, and it does disclose one genuinely useful trait: the bridge lacks GoalBlock support so the goal is applied via goto. It says nothing about whether an existing goal is replaced, permissions, or completion semantics (output schema covers the return value).

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 no filler; the core action leads and the caveat trails. Nothing redundant.

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?

The output schema exists, so return values need not be explained. However, for a navigation-mutation tool with no annotations and three undocumented required parameters, the description should do more to cover prerequisites, goal-replacement behavior, and sibling routing.

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%: x, y, and z are bare integers with no titles beyond single letters. The description never clarifies whether these are absolute world coordinates, chunk-relative, or target block types, so the agent must guess the meaning of all three required parameters.

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 action (apply a block-level navigation goal) and the resource (block coordinates). It even notes the implementation path (goto command, no GoalBlock support), but it never distinguishes itself from close siblings such as goal_coordinates, goto_block_type, or clear_goal.

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 guidance on when to use this instead of the clearly related siblings (goal_coordinates, goto_block_type, thisway, path, clear_goal). The mention of the goto command is an internal implementation detail, not a when-to-use rule for the agent.

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

set_settingC

Set a Baritone setting. For booleans, the value is option (toggles if omitted in chat, but here we require value).

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes
valueYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It clarifies that value is required for booleans (no toggle behavior), which is useful, but does not state whether changes persist across sessions, what validation occurs, what happens on invalid names, or what the return value contains.

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?

Two efficient sentences with the core purpose front-loaded. The parenthetical about chat behavior is slightly tangential but still informative and brief.

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

Completeness2/5

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

The tool has 2 required parameters with 0% schema coverage, no annotations, and no output schema cited. The description does not cover valid names, value types, persistence, or return behavior. It is incomplete for a configuration mutation tool.

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% for both parameters (name and value). The description only hints that value type depends on the setting (boolean example) but does not enumerate valid setting names or value types. With no schema documentation and no compensation in the description, an agent has little help mapping values to settings.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a verb (Set) and resource (Baritone setting), but does not explain what a Baritone setting is or distinguish this tool from sibling reset_setting, reset_all_settings, or get_modified_settings beyond the verb. Sibling differentiation is implied but not explicit.

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?

No guidance on when to use set_setting versus reset_setting or get_modified_settings. The only usage note is about boolean toggling in chat, which is not a condition for choosing this tool over alternatives.

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

snapshotC

Return a combined snapshot of bridge telemetry.

ParametersJSON Schema
NameRequiredDescriptionDefault
include_stateNo
include_missionNo
include_inventoryNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior2/5

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

No annotations provided, so the description carries the full burden. It doesn't state whether the call is read-only, whether it has side effects, whether it's rate-limited, or what 'combined' means. Only 'Return' implies a read, which is minimal.

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, front-loaded sentence with no filler. Efficient, though perhaps too terse given the tool's surface area.

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

Completeness2/5

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

Output schema exists, so return values don't need explaining. But with no annotations and zero parameter documentation, the definition is missing too much: no indication of scope ('bridge telemetry' undefined), no parameter meaning, no safety profile. Inadequate for an agent deciding whether to call it.

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 0%, and the description mentions no parameters at all. Three boolean parameters (include_state, include_mission, include_inventory) exist but are undocumented in both places. The description doesn't compensate for the coverage gap, but baseline for low coverage with a reasonable parameter count is around 3.

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: 'Return a combined snapshot of bridge telemetry'. Clear what it does, though 'bridge telemetry' is somewhat vague and it doesn't distinguish itself from siblings like poll_events, get_system_health_alerts, or version.

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?

No guidance on when to use this vs alternatives, no prerequisites, no mention of what 'bridge telemetry' comprises or when a snapshot is preferable to event polling or polling state separately.

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

start_miningC

Start the mining process for a given target block.

ParametersJSON Schema
NameRequiredDescriptionDefault
quantityNo
target_blockYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.8/5.0
Behavior2/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It only states the action and does not describe side effects, whether the operation is asynchronous, permission requirements, or how to stop the process (despite a sibling stop_mining existing). This leaves significant gaps.

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?

The description is a single, front-loaded sentence that conveys the tool's core purpose without any wasted words. It is appropriately sized for a simple action tool.

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

Completeness2/5

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

Given the complexity of starting a mining process, the lack of annotations, zero parameter descriptions, and minimal description text, the definition is incomplete. While an output schema exists for return values, the agent is missing critical context about usage, behavior, and parameter semantics.

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 compensate. It names the required target_block parameter implicitly, but the optional quantity parameter is not mentioned at all, leaving half of the parameters without any semantic explanation.

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 states a specific verb ('Start') and resource ('mining process') with a clear input scope ('for a given target block'), making the core purpose clear. However, it does not distinguish this tool from siblings like mine_quantity or stop_mining, leaving the agent to infer the difference.

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?

The description provides no guidance on when to use this tool versus alternatives, nor does it state any prerequisites or exclusions. The agent receives no context about appropriate scenarios.

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

start_schematic_uploadC

Start uploading a schematic file.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes
priorityNonormal
expected_sizeYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing. It doesn't state that this is likely a non-atomic, resumable upload flow, whether it requires prior authentication, what happens to an interrupted upload, or that cancellation is available via cancel_upload. Only the bare fact of initiating an upload is conveyed.

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 front-loaded sentence with zero padding, which is structurally clean. The brevity reflects under-specification rather than genuine economy, but as a conciseness measure it is efficient.

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

Completeness2/5

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

An output schema exists, so return values need not be explained. However, a mutation-style upload initiator with zero annotation coverage, 0% documented parameters, and two required arguments leaves the agent guessing about authentication, sequencing with get_upload_progress/cancel_upload, and failure modes.

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% across three parameters (name, priority, expected_size), and the description supplies no compensating detail. An agent cannot tell whether name is a local filename, a remote key, or a display label, nor what priority values are legal or how expected_size is used for validation.

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 ("start uploading") and resource ("a schematic file"), so the agent knows exactly what operation is being initiated. It stops short of differentiating from siblings like cancel_upload, get_upload_progress, or build_open_schematic, so it earns a 4 rather than a 5.

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 guidance on when to use this tool versus cancel_upload, get_upload_progress, or build_open_schematic, nor any prerequisites or sequencing hints. The word "Start" hints at a multi-step flow, but the description never says what to do next or when this is the right entry point.

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

stop_miningB

Stop the mining process.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It does not state whether stopping is idempotent, what happens if no mining is in progress, whether it's a graceful or hard stop, or whether state is lost. 'Stop' implies mutation but nothing is disclosed.

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 efficient sentence with no waste. It is front-loaded and appropriately sized, though it is arguably underspecified rather than truly concise.

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?

An output schema exists, so return values need not be explained, and there are no params. However, for a state-mutating control tool with no annotations, the description omits conditions, idempotency, and relationship to start_mining/cancel_command, leaving a meaningful completeness gap.

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?

Zero parameters, so baseline 4 applies. There are no parameter semantics to add meaning to, and the description correctly does not invent parameters.

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?

Clear verb+resource: 'Stop the mining process.' An agent can understand what it does without opening a schema. However, it doesn't differentiate from sibling 'cancel_command' or distinguish itself relative to 'start_mining' beyond the obvious stop/start pairing.

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?

No when-to-use or when-not-to-use guidance. It does not mention alternatives such as cancel_command, nor state conditions (e.g., only valid if mining is active). The pairing with start_mining is implied by name only.

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

subscribe_eventsC

Subscribe to real-time event streaming for specified event types.

ParametersJSON Schema
NameRequiredDescriptionDefault
event_typesYes
priority_thresholdNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden. It does not disclose whether the subscription is persistent, how events are delivered, whether unsubscribe_events is required to stop it, rate limits, or auth requirements. 'Real-time event streaming' is the only behavioral hint.

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?

One efficient sentence with no waste, front-loaded verb+resource. Nothing extraneous, though being a single short sentence it also carries no structure to organize richer content.

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

Completeness2/5

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

An output schema exists so return values need not be explained, but for a subscription tool with 0% param coverage, no annotations, and no lifecycle/cleanup context (unsubscribe_events is a sibling), the description leaves substantial gaps an agent needs to invoke it correctly.

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% and both parameters (event_types, priority_threshold) lack any description in the schema. The children tool description mentions 'specified event types' generically but adds no meaning for priority_threshold or valid event type values.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a verb (subscribe) and resource (real-time event streaming) which is clear enough. However it does not distinguish itself from siblings like poll_events or subscribe_mission_updates, leaving the agent to infer the difference between streaming subscription and polling.

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?

No when-to-use guidance, no mention of when to prefer this over poll_events or subscribe_mission_updates, and no prerequisites or cleanup (unsubscribe_events) noted. The agent gets no routing help.

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

subscribe_mission_updatesC

Subscribe to real-time mission state updates and collaborative mission events.

ParametersJSON Schema
NameRequiredDescriptionDefault
priority_thresholdNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior2/5

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

No annotations exist, so the description carries the full behavioral burden. It hints at push/real-time delivery, but says nothing about subscription lifecycle (how to stop, cf. unsubscribe_mission_updates), delivery channel, buffering, or any auth/permission requirements for a persistent stream.

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 zero filler. It is appropriately sized and states the resource immediately.

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?

An output schema exists, so return values need not be described. But for a subscription tool with no annotations, the description omits the parameter's meaning and the subscription lifecycle, leaving real gaps despite its brevity.

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?

There is one optional parameter (priority_threshold) with 0% schema description coverage and no description text. The description never mentions filtering or what the threshold means, so it fails to compensate for the schema gap.

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 ('Subscribe to real-time mission state updates and collaborative mission events'), which is clear on its own. However, it does not differentiate itself from close siblings such as subscribe_events, poll_events, or unsubscribe_mission_updates, so an agent must infer which subscription to pick.

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?

No when-to-use guidance is given and no alternatives are named. The presence of subscribe_events, poll_events, and unsubscribe_mission_updates as siblings makes the missing routing information notable, but the description offers none.

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

surfaceC

Head towards the closest surface-like area.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/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, yet it discloses nothing about execution: whether the move is blocking, whether it uses pathfinding, whether it can fail or get stuck, permissions, or side effects. 'Surface-like' is not explained.

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 short imperative sentence with no filler, and the action is front-loaded. It is efficient, though its brevity borders on under-specification rather than tight editing.

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?

An output schema exists, so return values need not be described, and there are no parameters to cover. Still, the central ambiguity ('closest surface-like area') and total absence of behavioral detail leave an agent without enough to predict the tool's behavior.

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, and the description does not invent any. Baseline 4 applies since there is no parameter surface to document.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

It gives an action ('Head towards') and a target ('closest surface-like area'), so it is not a tautology of the name 'surface'. However, 'surface-like area' is vague and undefined, and nothing distinguishes it from movement siblings such as 'explore', 'thisway', 'come', or 'path'.

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?

No guidance on when to use this versus the many other navigation tools ('explore', 'thisway', 'path', 'goal_coordinates'). The intended scenario must be inferred entirely from the one sentence.

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

thiswayB

Go in the direction you are facing for a specified number of blocks.

ParametersJSON Schema
NameRequiredDescriptionDefault
blocksYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden. It states relative movement but omits side effects such as collision handling, obstruction behavior, whether blocks are broken, permissions, failure modes, and state changes.

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 no filler, appropriate for a one-parameter tool.

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?

The tool is low-complexity and has an output schema, so return values need not be explained. However, with no annotations and no sibling routing, the definition is only minimally complete for selecting this over other navigation commands.

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 coverage is 0% and the schema only defines 'blocks' as an integer. The description compensates minimally by clarifying it is a number of blocks, but it gives no sign, range, or constraint semantics.

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?

Names the action (go), the direction basis (facing), and the distance parameter, so the basic operation is clear. It does not differentiate from sibling navigation tools like path, goto_block_type, or come, so it misses a 5.

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?

No indication of when to use this tool versus alternatives such as path, goto_block_type, follow_entity, or come. There are no prerequisites, exclusions, or contextual triggers provided.

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

tunnelC

Dig a tunnel with specified dimensions.

ParametersJSON Schema
NameRequiredDescriptionDefault
depthYes
widthYes
heightYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It implies a mutating/destructive dig operation, but does not disclose permissions, reversibility, block handling, rate limits, or side effects, leaving significant gaps for a world-editing action.

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?

The description is a single front-loaded sentence with no wasted words. It is appropriately concise, though its terseness leaves no room for the context an agent needs beyond the basic purpose.

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

Completeness2/5

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

With no annotations, no parameter descriptions, and an output schema that only covers returns, the description is too sparse for a 3-required-parameter mutation tool. It lacks usage guidance, parameter semantics, and behavioral disclosure that an agent needs to invoke it correctly.

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 compensate. It refers only to "specified dimensions" without naming height, width, or depth or explaining units, constraints, origin, or coordinate behavior, adding very little semantic meaning beyond the bare parameter names.

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 states a specific verb and resource: "Dig a tunnel". This is clear and avoids tautology, but it does not differentiate the tool from siblings such as start_mining or mine_quantity, nor does it clarify the tunnel's scope or context.

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 guidance on when to use this tool versus alternatives like start_mining or path. The phrase "with specified dimensions" implies a use case but does not state prerequisites, exclusions, or routing conditions.

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

unsubscribe_eventsC

Unsubscribe from real-time event streaming for specified event types.

ParametersJSON Schema
NameRequiredDescriptionDefault
event_typesYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.7/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden, yet it only restates the operation. It is silent on whether removing a subscription is idempotent, what happens to in-flight events, whether errors are returned for non-subscribed types, and whether scope is session- or globally-bound.

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 economical sentence with the verb front-loaded and no filler. It is well-formed but too thin to earn a 5 for structure given the disclosure gaps elsewhere.

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

Completeness2/5

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

An output schema exists, so return values need not be explained, but for a state-mutating streaming control tool with zero annotations and zero schema documentation, the description leaves the agent without the preconditions and effects needed to call it confidently.

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% for the single required parameter, so the description must compensate and largely does not. 'Specified event types' loosely maps to event_types, but it omits format expectations, whether the list must match prior subscriptions, and whether an empty list unsubscribes from everything.

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 ('Unsubscribe') and resource ('real-time event streaming'), making the inverse of subscribe_events immediately legible. It does not explicitly name or distinguish itself from the sibling subscribe_events or poll_events tools, so it falls short of a 5.

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, when-not-to-use, or prerequisite guidance. The description never states whether this must be preceded by subscribe_events, whether it stops all streaming or only the listed types, or how it relates to poll_events as an alternative.

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

unsubscribe_mission_updatesB

Unsubscribe from real-time mission state updates.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/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, and it discloses almost nothing: it does not say whether the call is idempotent, whether it errors when no subscription exists, or whether it affects other subscribers. The one fact it adds beyond the name is the real-time/push nature of what is being stopped, which is minimal.

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 verb first and zero filler. Nothing to trim.

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?

An output schema exists, so return values need not be explained, and a no-arg tool is inherently simple. However, the stateful subscription lifecycle (what happens if there is no active subscription, whether state is retained) is left unaddressed, leaving it only minimally viable.

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 per the rubric the baseline is 4. Nothing in the schema needs compensating for, and the description correctly implies a global/session-level operation.

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 pair ("unsubscribe" + "mission state updates") that an agent can act on directly. It does not name or differentiate from its obvious sibling subscribe_mission_updates, so it falls short of the 5 tier.

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?

No when-to-use guidance, no pairing instruction (e.g. "call after subscribe_mission_updates when you no longer need pushes"), and no mention of the sibling unsubscribe_events alternative. Usage is only inferable from the verb itself.

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

versionA

Get the version of Baritone.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.5/5.0
Behavior3/5

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

No annotations are supplied, so the description carries the full burden, but it omits what the version refers to (Baritone mod version, API version, protocol version) and whether the value is cached or live. The operation is a trivial, side-effect-free read, so the missing behavioral detail is minor rather than critical.

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?

One short, front-loaded sentence with zero filler. Nothing could be removed without losing meaning.

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?

An output schema exists, so the description need not explain the return value. For a no-parameter read tool this is nearly complete; only the meaning of 'version' briefly remains ambiguous.

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 to document and the baseline of 4 applies. The empty schema is consistent with the description.

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 and resource: 'Get the version of Baritone.' An agent can immediately tell this returns the Baritone build/version identifier, which is distinct from all siblings. It stops short of 5 only because there is no differentiation or scoping detail, though none is strictly required here.

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 guidance on when to use this tool, no preconditions, and no alternatives mentioned. For a trivial informational call this matters less, but the dimension is still essentially unaddressed.

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

wp_deleteC

Delete a waypoint by name.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.8/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden for a destructive operation. It says only 'delete' and does not disclose whether deletion is permanent, whether it errors on a missing waypoint, whether it requires prior save/permissions, or what the response contains.

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 short sentence with zero filler, and the identifying parameter is front-loaded. Nothing redundant or padded.

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

Completeness2/5

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

An output schema exists, so return values need not be explained, but for an unannotated mutation tool the description should cover irreversibility, failure modes, and prerequisite state. None of that is present, leaving key gaps for an agent to call it safely.

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?

The single 'name' parameter has 0% schema description coverage, so the description must compensate. 'By name' merely restates the parameter name and adds no format, case-sensitivity, or matching-rule details.

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 (delete) and resource (waypoint), so the agent knows exactly what the tool does. It does not name or contrast with siblings like wp_save or wp_list, but the wp_ prefix and the delete verb make it distinguishable without opening a schema.

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?

No guidance on when to use this versus wp_save/wp_list/wp_goal, no preconditions, and no note about what happens if the waypoint does not exist. The agent must infer usage entirely from the tool name.

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

wp_goalC

Set a goal to a waypoint.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full disclosure burden. It does not say whether an existing goal is overwritten, whether the waypoint must pre-exist, whether this persists across sessions, or whether navigation starts immediately — all material for a goal-setting mutation.

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?

A single short sentence is front-loaded and wastes no words. But brevity here shades into under-specification rather than economy — the terseness removes information the agent needs rather than trimming redundancy.

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

Completeness2/5

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

An output schema exists, so return values need not be described. Everything else is missing, though: no relations to the many waypoint/goal siblings, no parameter meaning, and no behavioral context for a mutation tool with zero annotation coverage.

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% and the single parameter "name" is undocumented. The description strongly implies "name" refers to a waypoint, but it never states whether it is a waypoint identifier, a goal label, or a coordinate string, so the critical ambiguity is unresolved.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The verb-and-resource pairing is present ("Set a goal" + "waypoint"), so the general intent is understandable. However, the phrasing is ambiguous — it is unclear whether it sets a goal located at a waypoint or assigns a waypoint as a goal — and it does no work to distinguish itself from siblings like goal_coordinates, set_goal_block, or wp_list.

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 guidance on when to use this versus goal_coordinates, set_goal_block, or clear_goal, nor any stated preconditions (e.g., must a waypoint already exist via wp_save). The agent is left to infer usage entirely from the name.

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

wp_listC

List waypoints with a specific tag.

ParametersJSON Schema
NameRequiredDescriptionDefault
tagYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2/5.0
Behavior1/5

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

With no annotations and no output schema disclosure beyond existence, the description carries full behavioral burden but provides none. It doesn't state whether the operation is read-only (implied but not confirmed), authentication requirements, rate limits, or what the output contains. For a tool with zero annotation coverage, this is inadequate.

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?

The single sentence is concise and front-loaded, with no wasted words. However, its brevity comes at the cost of clarity and completeness, so it's efficient but under-informative.

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

Completeness2/5

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

Given a tool with one required parameter, no annotations, 0% schema coverage, and an output schema (which might cover returns), the description is still inadequate. It leaves critical behavioral and parameter details unspecified, making it difficult for an agent to use the tool correctly without additional investigation.

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 compensate. It merely repeats the parameter name 'tag' without adding format, validation rules, or examples. No meaning is added beyond what the schema's bare 'tag' property already conveys.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'List waypoints with a specific tag' restates the tool name (wp_list) and its single parameter without adding meaningful specificity. It vaguely indicates retrieval of waypoints filtered by tag, but the terse phrasing borders on tautology and doesn't distinguish itself from siblings like wp_save, wp_delete, or wp_goal beyond the obvious verb.

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 guidance on when to use this tool versus alternatives. The description doesn't mention prerequisites, edge cases (e.g., what happens with an unknown tag, whether it requires existing waypoints), or context for choosing this over other waypoint tools.

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

wp_saveB

Save a waypoint. Uses current position if coordinates are not provided.

ParametersJSON Schema
NameRequiredDescriptionDefault
xYes
yYes
zYes
nameYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden. It discloses one useful trait — that missing coordinates fall back to current position — but says nothing about overwrite behavior on duplicate names, persistence across sessions, or required permissions for a write operation.

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?

Two short sentences with the primary action front-loaded and the fallback behavior immediately after. No filler, nothing redundant.

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?

An output schema exists, so return values need not be explained. But for a mutation tool with zero annotation coverage and 0% parameter description coverage, the description should do more to cover write semantics such as name collisions or overwrite behavior.

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 0%, so the description must compensate, and it does explain the key ambiguity: x/y/z can be omitted in favor of current position. However, the schema marks all four as required, and the description never clarifies that the `name` parameter is mandatory or how to pass null coordinates, leaving a gap.

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 and resource ("Save a waypoint"), which is unambiguous. It does not explicitly distinguish itself from siblings like wp_list, wp_delete, or wp_goal, but the verb makes the distinction inferable. Clear but without sibling differentiation.

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 guidance on when to use this tool versus wp_goal, save_all, or wp_delete, nor any stated prerequisites. The only usage hint is the coordinate fallback, which is about parameter behavior rather than tool selection.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 69 tool updatesv0.1.0
    • First observedaxis
    • First observedbatch_command
    • First observedblacklist
    • First observedbroadcast_mission_state
    • First observedbuild_open_schematic
    • First observedbuild_schematic
    • First observedcache_block
    • First observedcancel_command
    • First observedcancel_upload
    • First observedclear_cache
    • First observedclear_goal
    • First observedclick
    • First observedcome
    • First observeddamn
    • First observedeta
    • First observedexplore
    • First observedfarm
    • First observedfind
    • First observedfollow_entity
    • First observedfollow_player
    • First observedgc
    • First observedget_cached_block
    • First observedget_command_analytics
    • First observedget_modified_settings
    • First observedget_performance_trends
    • First observedget_rate_limit_info
    • First observedget_system_health_alerts
    • First observedget_upload_progress
    • First observedgoal_coordinates
    • First observedgoto_block_type
    • First observedhelp_command
    • First observedinspect_build_site
    • First observedinvert
    • First observedmine_quantity
    • First observedminecraft_describe_tool
    • First observedminecraft_help
    • First observedmission_checkpoint
    • First observedmission_macro
    • First observedmission_queue
    • First observedpath
    • First observedpoll_events
    • First observedpreview_build_plan
    • First observedproc
    • First observedread_file
    • First observedreload_all
    • First observedrender
    • First observedrepack
    • First observedreset_all_settings
    • First observedreset_setting
    • First observedrun_command
    • First observedsave_all
    • First observedset_goal_block
    • First observedset_setting
    • First observedsnapshot
    • First observedstart_mining
    • First observedstart_schematic_upload
    • First observedstop_mining
    • First observedsubscribe_events
    • First observedsubscribe_mission_updates
    • First observedsurface
    • First observedthisway
    • First observedtunnel
    • First observedunsubscribe_events
    • First observedunsubscribe_mission_updates
    • First observedversion
    • First observedwp_delete
    • First observedwp_goal
    • First observedwp_list
    • First observedwp_save

TDQS

C2.3/5.0

Scored across 69 tools

Disambiguation2/5

Many tools overlap in purpose: run_command/batch_command/mission_macro/mission_queue for execution, and numerous pathing/exploration variants (path, goal_coordinates, goto_block_type, come, thisway, axis, surface, explore). Several legacy commands (proc, eta, find, gc, damn) have vague descriptions, making it hard for an agent to choose reliably.

Naming Consistency2/5

Names mix single-word Baritone commands (find, path, explore, invert, damn) with snake_case verb_noun tools (set_goal_block, subscribe_events, wp_save). No consistent pattern is applied across the set; prefixes like wp_, mission_, and get_ are not used systematically.

Tool Count1/5

69 tools is extreme for this surface; many are niche legacy commands or redundant wrappers, far exceeding a well-scoped 3-15 tool set. The count creates a high cognitive load and increases misselection risk.

Completeness4/5

The set broadly covers pathing, mining, building schematics, waypoints, settings, cache, events, uploads, and command execution, suggesting fairly complete coverage for Baritone automation. Minor gaps and oddities remain, such as the non-functional 'damn' tool and some lifecycle operations being implicit via run_command.

Maintenance

ActivityActive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers