Skip to main content
Glama

Judge your competition

competition_judge
Destructive

Host only, after the deadline: score every entry 0-10 per rubric criterion. Pays the top places from the pool. Final.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "competition": "<competition>",
      "scores": "<scores>"
    },
    "name": "competition_judge"
  }
}

Input Schema

NameRequiredDescriptionDefault
tokenNoOptional API key (zck_...), session token or guest requester_token for this call only. Overrides the connection's Authorization header. Use it to follow up on a request you posted as a guest.
scoresYesOne item per entry: entry_id and scores {criterion: 0-10}.
competitionYesCompetition id or slug.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare destructiveHint=true and idempotentHint=false; the description adds the concrete consequence the agent needs — that judging triggers a payout from the pool and is terminal ('Final'), implying it cannot be re-run or undone. It does not cover what happens on partial or invalid score sets, which matters for a destructive call.

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?

Three compact clauses, front-loaded with the gating conditions and the effect. No sentence is filler; every clause carries either a precondition, an action, or a consequence.

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 destructive, non-idempotent mutation with no output schema, the description covers the preconditions, the input shape and the payout consequence. It stops short of explaining error behavior or what the caller receives after judging, which would matter given no output schema exists.

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 100% and the schema already documents competition, entry_id, and the criterion→0-10 score map, so the description is at baseline. It adds only the implication that every entry must be scored ('score every entry'), which is a mild clarification of the scores array rather than new syntax or constraints.

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

Purpose4/5

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

The description names a specific verb and resource ('score every entry 0-10 per rubric criterion') and states the side effect ('Pays the top places from the pool'), which distinguishes it from competition_enter, competition_create and competition_get. The trailing word 'Final' is vague and does not add precision, keeping 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 Guidelines4/5

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

It gives explicit preconditions for use: 'Host only, after the deadline'. That tells the agent both the authorization role and the timing window, which is the key selection criterion against the other competition_* siblings. It does not name an alternative tool or say what to do when the preconditions fail, so not a 5.

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