search_battles
List WarEra battles, optionally filtering by country or active or finished state. Retrieve each side's country name and ID, and page through results with a cursor.
Instructions
List battles, optionally filtered by country and active state. Each side includes the human-readable country name and id. Without a filter this is the first upstream page, and its ordering is not guaranteed, so do not describe it as 'latest'. For a battle leaderboard use get_battle_ranking.
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": "search_battles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (1-10). | |
| cursor | No | Cursor from a previous page's `next_cursor`. Treat it as opaque. | |
| is_active | No | Filter to active or finished battles. | |
| country_id | No | Filter by country id. | |
| player_context | No | Optional per-request WarEra credentials: an object containing api_key or jwt. Never use a project-wide or default credential. |