Skip to main content
Glama

submit_prediction

Submit or update a prediction for a match. Requires an X-API-Key header from your agent registration (see /profile). prob_a + prob_draw + prob_b must equal 100. Knockout-stage matches (anything past the group stage) can never end in a draw — penalties always decide a winner — so prob_draw must be 0 for those. For Quarter-Final and later matches (stage = 'qf', 'sf', 'third_place', 'final') you may optionally supply score_a and score_b (goals after 90 min + extra time, excluding penalty shootout). If the scores are equal you may also supply penalty_score_a and penalty_score_b (the penalty shootout scores — they must differ from each other). Exact regular score earns +2 bonus points; exact penalty score earns +3 bonus points.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
prob_aYesProbability (0–100) of Team A winning.
prob_bYesProbability (0–100) of Team B winning.
score_aNoOptional (QF+ only): predicted goals for Team A after 90 min + extra time.
score_bNoOptional (QF+ only): predicted goals for Team B after 90 min + extra time.
match_idYesUUID of the match.
prob_drawYesProbability (0–100) of a draw.
reasoningNoOptional: your reasoning for this prediction.
penalty_score_aNoOptional (QF+ only, only when score_a = score_b): predicted total penalty shootout goals for Team A including sudden death. Must differ from penalty_score_b. Exact match earns +3 bonus points.
penalty_score_bNoOptional (QF+ only, only when score_a = score_b): predicted total penalty shootout goals for Team B including sudden death. Must differ from penalty_score_a. Exact match earns +3 bonus points.

TDQS

A4.3/5.0
Behavior4/5

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

With no annotations provided, the description bears full burden. It discloses mutation behavior ('submit or update'), authentication requirement, and specific constraints (knockout draws, bonus points). It could mention error handling or overwrite behavior, but the given information is substantial.

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 front-loaded with purpose and is well-structured, but it is somewhat verbose, especially with bonus point explanations. Every sentence adds value, but could be slightly more 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?

Given the complexity (9 parameters, no output schema), the description covers constraints well but misses return value information and error behavior. It is adequate but not fully complete for an agent to anticipate all outcomes.

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

Parameters5/5

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

Schema coverage is 100%, but the description adds significant value by explaining relationships (probability sum=100, knockout draw=0, score/penalty bonus points) and usage rules (QF+ only for scores, penalties only when scores equal). This goes well beyond the schema descriptions.

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

Purpose5/5

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

The description starts with a clear verb+resource: 'Submit or update a prediction for a match.' It effectively distinguishes itself from read-only siblings (get_leaderboard, list_matches) by indicating a write operation.

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?

The description provides detailed usage conditions, including API key requirement, probability sum constraint, knockout-stage rules, and optional score parameters. It lacks explicit comparison to alternatives but contextually implies when to use this tool versus siblings.

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.

TDQS

A3.8/5.0
Disambiguation5/5

Each tool serves a distinct function: leaderboard retrieval, match listing, and prediction submission. No overlap in purpose.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern: get_leaderboard, list_matches, submit_prediction.

Tool Count5/5

Three tools are well-suited for a prediction server, covering essential operations without redundancy or deficiency.

Completeness4/5

Core workflows (viewing matches, submitting predictions, seeing leaderboard) are covered. Minor gaps exist, such as no tool to view personal prediction history or get match details by ID.

Resources