Skip to main content
Glama

ResearchPilot

researchpilot_validate_specialist_receipt

Read-onlyIdempotent

Validate a specialist execution receipt against its ResearchPilot request and authenticated project/context identity. This verifies identity, input digests, sample accounting, diagnostics and validation-state structure; it does not independently validate scientific correctness.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
receiptYes
requestYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint=false, and destructiveHint=false, so the safety profile is covered. The description adds meaningful behavioral context by enumerating what the validation checks (identity, input digests, sample accounting, diagnostics, validation-state structure) and by explicitly disclaiming independent scientific-correctness validation. It does not describe failure behavior or return format, but it adds substantial scope beyond the annotations.

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 two tightly written sentences with no wasted language. The primary action and scope are front-loaded, and the limitation is clearly stated afterward.

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 description explains the validation scope and its main limitation, which is useful for a complex receipt-checking tool. However, with two nested object parameters, zero schema coverage, and no output schema, it leaves important gaps: what the request and receipt objects should contain and what the validation result looks like. It is adequate but not complete for an agent to invoke 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?

Both parameters are required nested objects with 0% schema description coverage, so the description carries the full burden of explaining them. It refers to a request and a receipt, which identifies their roles in the validation, but it provides no structural detail, expected fields, or minimum content for either object. This is a significant gap for two nested-object 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?

The description states a specific verb and resource: validate a specialist execution receipt against its ResearchPilot request and authenticated project/context identity. It also clearly scopes the check by listing what is verified and explicitly excluding independent scientific-correctness validation. It does not directly name sibling tools, but the operation is specific enough to distinguish it from preparation or evidence-reading 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?

Usage is implied by the validation workflow: this tool is for checking a specialist receipt against its originating request and identity context. The description notes a boundary (it does not validate scientific correctness), which helps avoid misuse, but it does not explicitly state when to call it, prerequisites such as a prior execution step, or an alternative tool for correctness checks.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources