Skip to main content
Glama

Yardstick ATS

Make sure an interview exists for a round

yardstick_application_interview_sessions_ensure
Idempotent

Ensure an application interview session for an explicit round id.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
round_idYes
request_idNo
round_titleNo
application_idYes
idempotency_keyNo
interview_plan_idNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.7/5.0
Behavior3/5

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

Annotations already flag idempotentHint=true, readOnlyHint=false, destructiveHint=false; the description is consistent and adds the end-state idea that a session will exist for the round. It does not state what happens when one already exists, whether it creates or reuses, what it returns, or any permission/rate-limit context, so credit is limited.

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 dense sentence with no filler and the key id (round) is front-loaded. It is concise to the point of under-specification, but as far as structure and length it earns its place.

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 output schema, 0% parameter coverage, and no behavioral detail, this is too thin for reliable invocation. An agent cannot predict the return value, the effect on an existing session, or the role of the optional parameters, and there is no pointer to sibling 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 descriptions cover 0% of six parameters, and the description only references round_id (and application_id by tool-name inference). Optional params like round_title, request_id, idempotency_key, and interview_plan_id get no explanation, so an agent cannot tell what values to supply.

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 title and description name a specific resource ('application interview session') and scope it to an explicit round id, with 'Ensure'/'Make sure an interview exists' conveying an idempotent create-if-missing intent. This is enough to distinguish it from list/read/cancel/start session tools, though 'Ensure' alone is slightly vague.

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 sentence tells an agent when to choose this over yardstick_application_interview_sessions_list or the interview_sessions_* lifecycle tools, and no exclusions or alternatives are named. The only implicit signal is the word 'Ensure', which is too weak to route reliably.

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.