tarkov-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TARKOV_LANG | No | One of the API's supported language codes | en |
| TARKOV_API_BASE | No | Base URL of the API | https://json.tarkov.dev |
| TARKOV_GAME_MODE | No | One of regular, pve, pvp-season | regular |
| TARKOV_CACHE_TTL_MS | No | How long cached bulk datasets stay fresh (1 hour) | 3600000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_itemsA | Search Escape from Tarkov items by name/short name (substring match). Optionally filter by item type (e.g. 'gun', 'ammo', 'armor', 'barter') and/or by a trader that buys or sells the item. Returns compact summaries (id, name, prices) — use get_item for full detail on one item. |
| get_itemA | Get full detail for one item by id or name, including flea market pricing, trader buy/sell offers, and weapon/armor/ammo properties. Trader and item ids referenced within the result are resolved to names. |
| get_item_price_historyB | Get flea market price history (min price, average price, timestamp) for one item. The full history can span years and thousands of points; by default only the last 30 days are returned — widen with |
| list_tradersA | List all Escape from Tarkov traders with their currency and next restock/reset time. |
| get_traderA | Get full detail for one trader by id or name (e.g. 'Prapor', 'Therapist'), including loyalty levels (pay rate, insurance rate, required reputation) and buy/sell restrictions. |
| list_mapsA | List all Escape from Tarkov maps with raid duration, player count, and enemy types. |
| get_mapA | Get detail for one map by id or name (e.g. 'Customs', 'Factory'): extracts, hazards, boss spawn chances and zones, transits, access requirements. Raw coordinate/outline data is omitted by default since it's not useful for answering questions in text — set includePositions to get exact coordinates instead. |
| search_tasksA | Search Escape from Tarkov tasks/quests by name (substring match), optionally filtered by trader and/or map. Returns compact summaries — use get_task for full objectives/requirements/rewards. |
| get_taskA | Get full detail for one task/quest by id or name: objectives, requirements, rewards, and failure outcomes. Trader/item/map ids referenced within the result are resolved to names. |
| list_hideout_stationsA | List all hideout stations (e.g. Workbench, Medstation, Library) with their max level. |
| get_hideout_stationA | Get full detail for one hideout station by id or name, including every level's construction time, required items, required trader loyalty, and required other stations. Item/station ids are resolved to names. |
| search_bartersA | Find trader barter offers (trade items instead of paying cash) involving a given item and/or trader. Item/trader ids in the results are resolved to names. |
| search_craftsA | Find hideout craft recipes involving a given item and/or hideout station. Item/station ids in the results are resolved to names. |
| get_server_statusA | Get the current live status of Escape from Tarkov's servers (website, launcher, game servers, etc.). Always fetched fresh, not cached. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool targets a distinct resource/action pair: list/get for maps, traders, and hideout stations; search/get for items and tasks; plus dedicated price history, barters, crafts, and server status. No two tools appear to serve the same purpose.
All tool names follow a consistent snake_case verb_noun pattern (list_*, get_*, search_*) with predictable singular/plural usage. Longer names like get_item_price_history and get_server_status still fit the same convention.
14 tools is well within the ideal range and each tool covers a meaningful slice of the Tarkov domain without redundancy. The count feels appropriately scoped for a game-data server.
The surface covers the main domain resources: items, traders, maps, tasks, hideout stations, barters, crafts, and live server status. Minor gaps exist, such as no list_all_items endpoint or dedicated get_barter/get_craft detail tools, but agents can complete most workflows with search + get.