Tarkov

You run a dedicated MCP server that exposes Escape from Tarkov game data through the Tarkov API. This server lets you query items, markets, maps, traders, quests, and community reports in a structured, programmable way, so your client tools, bots, or dashboards can fetch up-to-date Tarkov data efficiently.

How to use

Start the MCP server on your machine and connect client tools to it. The server runs as a local process and exposes data endpoints via a standard input/output (stdio) interface. You can fetch item details, market prices, trader inventories, quest data, map spawns, and community reports by issuing requests through your MCP client. Use the provided environment variables to point the server at the Tarkov API and to tune request rate limits and timeouts. Typical usage patterns include querying item details for a specific item, listing market prices for multiple items, and retrieving quest objectives and rewards.

To start the server, run the runtime command exactly as shown in the start instructions. If you are using a client that automates MCP launches, supply the same command so the client can spawn the server as a child process and establish a request/response channel. Once running, you can perform requests such as fetching item data, flea market data, hideout modules, and map details. The server supports localization, multi-language responses, and detailed error messages to help you diagnose issues quickly.

How to install

Prerequisites you need before installation are Python 3.8 or higher and the pip package manager.

Install dependencies in one of the following ways. Choose the option that fits your workflow.

Option 1: Install as a package (recommended)

pip install -e .

Option 2: Install with development dependencies

pip install -e ".[dev]"

Option 3: Using requirements.txt (legacy)

pip install -r requirements.txt

Claude Desktop setup: add a configuration entry that starts the MCP server via Python and the module name, so Claude Desktop can launch it for you. The config path depends on your operating system.

{
  "mcpServers": {
    "tarkov": {
      "command": "python",
      "args": ["-m", "tarkov_mcp"],
      "cwd": "/path/to/tarkov-mcp"
    }
  }
}

Replace /path/to/tarkov-mcp with the actual path to this project directory. After updating the config file, restart Claude Desktop for the changes to take effect.

## Additional configuration and startup

The server supports environment variables to customize operation. The following variables are commonly used:

- `TARKOV_API_URL` — Tarkov API endpoint (default: https://api.tarkov.dev/graphql)
- `MAX_REQUESTS_PER_MINUTE` — Rate limit (default: 60)
- `REQUEST_TIMEOUT` — Request timeout in seconds (default: 30)

To start the server locally after dependencies are installed, run the following command.

python -m tarkov_mcp

## Available tools

### search\_items

Search for items by name or type with localization support.

### get\_item\_details

Retrieve detailed item information including prices, stats, and usage.

### get\_item\_prices

Fetch current pricing information for items.

### compare\_items

Compare multiple items side by side to evaluate differences.

### get\_quest\_items

Obtain quest-specific items and their associated tasks.

### get\_flea\_market\_data

Access current flea market price data.

### get\_barter\_trades

Retrieve available barter exchanges from traders.

### calculate\_barter\_profit

Analyze profit or loss for barter trades.

### get\_ammo\_data

Provide ammunition statistics and pricing.

### get\_hideout\_modules

Show hideout module information and requirements.

### get\_maps

List all available maps.

### get\_map\_details

Get detailed map information including spawns and exits.

### get\_map\_spawns

Fetch spawn locations for specific maps.

### get\_traders

List all traders.

### get\_trader\_details

Provide detailed trader information.

### get\_trader\_items

List items available from specific traders.

### get\_quests

List quests, with optional trader filtering.

### get\_quest\_details

Detailed quest information including objectives and rewards.

### search\_quests

Search quests by name or description.

### get\_goon\_reports

Retrieve recent community-driven goon squad reports.