Skip to main content
Glama

World rankings

eu5_rankings

Rank countries by a chosen metric and show the player's position in an EU5 save to compare campaign standing.

Instructions

Rank countries by a metric and show the player's position.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "eu5_rankings"
  }
}

Input Schema

NameRequiredDescriptionDefault
saveNoSave to use: "latest", a file name like "autosave.eu5", or a full path. Defaults to the last loaded save, else the newest.
limitNo
metricNogreat_power_rank

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

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 behavioral burden, and it discloses very little: it doesn't say the tool is read-only, whether it operates on the loaded save by default, how many rows are returned, or what the output looks like. With zero annotation coverage this is a substantial gap for an agent that needs to reason about side effects and result shape.

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 or redundancy. It is efficient, though its brevity comes at the cost of the omissions 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?

For a three-parameter tool with no annotations and no output schema, the description should at minimum cover the return shape, the metric options, and the limit behavior. None of that is present, so an agent would have to open the schema and guess at semantics before calling 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 only 33%: only the save parameter is documented, while limit and metric have no schema descriptions beyond an enum list. The description mentions ranking 'by a metric' but never explains the available metrics, the meaning of limit, or the default of 15 rows, so it fails to compensate for the 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 states a specific verb and resource ("Rank countries by a metric") plus an extra output element ("the player's position"), which is more informative than the bare title. It does not distinguish itself from siblings like eu5_query or eu5_country_overview, so an agent cannot tell from the text alone why it should pick this tool over those.

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 such as eu5_query or eu5_country_overview, and no prerequisites or exclusions are mentioned. The only implied usage is 'to see rankings', which the agent must infer 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.