canonical: https://jentic.com/apis/developers.wargaming.net/wargaming

# Wargaming.net API

The Wargaming.net API serves player, vehicle, and clan data for World of Tanks. You can search accounts and read a player's profile, vehicles, and per-tank statistics, browse the vehicle encyclopedia, look up clans and their members, and read player ratings and global map standings. Every operation is a read that returns game data.

## For AI agents

Read World of Tanks player profiles, per-vehicle statistics, clan rosters, encyclopedia entries, ratings, and global map data through the Wargaming.net API. Read-only game data.

## Scope

Covers reading World of Tanks player, vehicle, and clan data. Does not modify accounts, handle purchases, or cover other Wargaming titles.

## Capabilities

- Search player accounts and read their profile details
- List a player's vehicles and per-tank statistics
- Browse the vehicle encyclopedia and game reference data
- Look up clans and their member rosters
- Read player ratings within a rating period
- Read global map clan and province standings

## Use cases

### AI Agent Player Stats Lookup

An AI agent can answer questions about a World of Tanks player by searching their account and reading their profile and per-tank statistics. Through Jentic the agent finds these read operations by intent and passes the account id, so a Discord bot or stats assistant can report win rates and vehicle performance without a developer wiring the endpoints by hand.

Example prompt: Search for a player by nickname, then read their overall statistics and return win rate and battle count

### Clan Roster and Standings Tracker

A community agent can track clans by looking up membership and global map standings. The API returns clan details, member lists, and province holdings, so an agent can report roster changes or a clan's position on the global map as part of a scheduled community update.

Example prompt: Look up a clan by name, list its current members, and report its global map province count

### Vehicle Encyclopedia Assistant

A reference agent can answer questions about specific tanks using the vehicle encyclopedia. The API returns vehicle specifications and game reference data, so an agent can compare tanks or explain a vehicle's stats to a player without maintaining its own game database.

Example prompt: Fetch the encyclopedia entry for a named tank and return its tier, type, and key specifications

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/wot/account/list/` | Search player accounts |
| GET | `/wot/account/info/` | Get player account details |
| GET | `/wot/account/tanks/` | List a player's vehicles |
| GET | `/wot/tanks/stats/` | Get per-vehicle statistics for a player |
| GET | `/wot/encyclopedia/vehicles/` | Get vehicle encyclopedia data |
| GET | `/wot/clans/list/` | Search clans |
| GET | `/wot/clans/info/` | Get clan details |
| GET | `/wot/ratings/accounts/` | Get player ratings |

## Key resources

- **Accounts** — Search players and read their profile, vehicles, and per-tank statistics
- **Encyclopedia** — Browse vehicle specifications and game reference data
- **Clans** — Look up clans, their details, and their member rosters
- **Ratings** — Read player ratings within a rating period
- **Global Map** — Read clan standings and province holdings on the global map

## Why Jentic

- **Setup:** Wiring Wargaming by hand means registering an application for an id, adding it to every request as a query parameter, and handling an optional player access token for private fields. Through Jentic you install once, import the API, store the credentials once, and your agent calls it.
- **Permission scoping:** You choose which Wargaming operations the agent may call. Since every operation is a read-only lookup, a rule can allow just player statistics, or just clan data, so the agent stays within the exact set of lookups you approved.
- **Credential handling:** Your Wargaming application id and any player access token are stored encrypted by your own Jentic One instance and injected as query parameters at execution time. They never enter the agent's prompt, logs, or context window.
- **Discovery method:** Agents search Jentic by intent such as 'get a player's statistics' or 'look up a clan', and Jentic returns the matching Wargaming operation with its input schema so the agent calls the right endpoint.

## Related APIs

- **PUBG** — The PUBG API exposes player and match statistics for another popular game.
- **IGDB** — IGDB is a broad games database covering titles, genres, and metadata.
- **Hearthstone API** — The Hearthstone API returns card and game data for another title.

## FAQ

### Is there a World of Tanks MCP server?

You don't need an MCP server to give your agent the Wargaming.net API. Jentic connects it directly from the API Directory: import it, store your application id once, and your agent can read player stats, clans, and encyclopedia data. Operations are discovered on demand, so no extra tool definitions sit in the agent's context.

### Can I limit what my agent is allowed to do with the Wargaming.net API?

Yes. Every operation is a read-only lookup, so you write a rule that allows only the ones you need, such as reading player statistics but not clan data. The agent cannot reach any operation you did not pick, and every call it makes is logged.

### What authentication does the Wargaming.net API use?

The Wargaming.net API requires an application id, sent as the application_id query parameter per its OpenAPI spec, and it accepts an optional access_token query parameter for data that needs the player's consent. Through Jentic these are stored encrypted by your own Jentic One instance and added at call time.

### Can my agent read a player's per-tank statistics with the Wargaming.net API?

Yes. After finding an account, the agent can read the player's overall statistics and their per-vehicle statistics, along with the list of tanks in their garage. This lets a stats assistant report win rates and performance for specific vehicles.

### What are the rate limits for the Wargaming.net API?

The OpenAPI spec does not specify rate limits. Check the Wargaming developer documentation at https://developers.wargaming.net for the current per-application request limits before running high-volume lookups.

### How do I read World of Tanks player stats through Jentic?

Search Jentic for 'get a World of Tanks player's statistics', import the operation, and store your application id once. Your agent then searches accounts and reads their stats on demand. To run it on your own infrastructure, install Jentic One from its GitHub repo.
