Skip to main content
Glama

List my battles

list_my_battles
Read-onlyIdempotent

Lists the signed-in player's battles, newest first, up to 25 a page, narrowed and ordered as the battles page is. Each battle has its url, status, your result, ending, size, mission and one entry per seat (you, side, army, faction, detachments, score with its primary and secondary halves, rating change). A filtered page can come back short or empty while nextCursor is set; keep paging until nextCursor is null. Requires mcp:read.

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": "list_my_battles"
  }
}

Input Schema

NameRequiredDescriptionDefault
orderNooldest for oldest first; omit for newest first.
beforeNonextCursor from the previous page; omit for the first page.
filterNo
llm_modelNoThe model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Pass "unknown" if you are not certain. Recorded for the server developer's analytics.
conversation_idNoThe conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / conversation_id
      Added value: +{
      +  "description": "The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics.",
      +  "type": "string"
      +}
    • addedInput schema / properties / llm_model
      Added value: +{
      +  "description": "The model identifier you are running as, for example \"claude-opus-4-8\" or \"gpt-5.2\". Pass \"unknown\" if you are not certain. Recorded for the server developer's analytics.",
      +  "type": "string"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / filter / properties / type / description
      Previous value: -"{in, out} lists of practice (against an automated opponent), guest, team, manual (table keeps its own score), organised (counts for a group or tournament). A battle must carry one of in (when given) and none of out."New value: +"{in, out} lists of practice (played alone, every side by you), guest, team, manual (table keeps its own score), organised (counts for a group or tournament). A battle must carry one of in (when given) and none of out."
  3. Changed3 schema fields changed
    • addedInput schema / properties / before / description
      Added value: +"nextCursor from the previous page; omit for the first page."
    • addedInput schema / properties / filter
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "against": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of faction slugs the opposing side fielded. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "againstDetachment": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of detachment names the opposing side fielded. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "deployment": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of deployment ids. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "detachment": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of detachment names your side fielded, exactly as shown, such as Awakened Dynasty. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "ending": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of completed, finished-early, conceded, reported. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "faction": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of faction slugs your side fielded, as list_factions gives them, such as necrons. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "from": {
      +      "description": "First UTC day to include, YYYY-MM-DD.",
      +      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +      "type": "string"
      +    },
      +    "pack": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of mission pack ids, as list_reference gives them. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "period": {
      +      "description": "Only battles from the last 7d, 30d, 90d or 1y; overrides from and to.",
      +      "enum": [
      +        "7d",
      +        "30d",
      +        "90d",
      +        "1y"
      +      ],
      +      "type": "string"
      +    },
      +    "player": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of player ids, from players[].id of a listed battle. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "q": {
      +      "description": "Text matched against player, army, faction, detachment and mission names.",
      +      "maxLength": 80,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "result": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of won, lost, drawn, read from your seat; only finished battles have one. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "size": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of battle sizes in points as text, such as 2000. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "status": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of setup, playing, finished. A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "to": {
      +      "description": "Last UTC day to include, YYYY-MM-DD.",
      +      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +      "type": "string"
      +    },
      +    "type": {
      +      "additionalProperties": false,
      +      "description": "{in, out} lists of practice (against an automated opponent), guest, team, manual (table keeps its own score), organised (counts for a group or tournament). A battle must carry one of in (when given) and none of out.",
      +      "properties": {
      +        "in": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        },
      +        "out": {
      +          "default": [],
      +          "items": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "maxItems": 40,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / order
      Added value: +{
      +  "description": "oldest for oldest first; omit for newest first.",
      +  "enum": [
      +    "oldest"
      +  ],
      +  "type": "string"
      +}
  4. Added

TDQS

A4/5.0
Behavior5/5

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

Beyond the readOnly/idempotent annotations it discloses the non-obvious pagination trap that a filtered page can be short or empty while nextCursor is set, plus the 25-per-page cap, newest-first default, and the required scope. Since there is no output schema, it also enumerates the per-battle and per-seat fields returned, which the agent could not otherwise infer.

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 sentences, front-loaded with what it returns and ordered by what the agent must do first (call, then page). The long field enumeration in the middle is dense but earns its place because no output schema exists.

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?

Covers return shape, page size, ordering, paging termination, and auth scope for a moderately complex 5-parameter tool with nested filter objects and no output schema. The gap is that the fifteen-plus filter dimensions are only gestured at with "narrowed and ordered as the battles page is," leaving the agent to discover the filter object from the schema.

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 description coverage is 80%, so the filter grammar, period override, and cursor shape are already documented in the schema. The description only reinforces the default ordering and the cursor loop, adding little parameter meaning the schema does not already carry.

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?

States a specific verb and resource ("Lists the signed-in player's battles") plus ordering and page size, which an agent can act on immediately. It does not explicitly distinguish itself from the single-battle sibling get_my_battle or from list_my_opponents, so the routing signal is clear but not fully disambiguated.

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?

Gives real operational guidance for paging ("keep paging until nextCursor is null") and states the mcp:read requirement, which is genuinely useful. However, it never says when to prefer this over get_my_battle or list_my_opponents, and "narrowed and ordered as the battles page is" defers filter semantics to an external UI without naming alternatives.

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