Tarkov MCP Server

A Model Context Protocol (MCP) server that provides comprehensive access to Escape From Tarkov game data through the tarkov.dev GraphQL API.

Overview

This MCP server allows AI assistants to access detailed information about Escape From Tarkov, including items, traders, maps, quests, crafting recipes, and much more. It's designed to be a comprehensive resource for players, developers, and AI applications that need Tarkov game data.

Features

Available Tools

The server provides 19 different tools to access various aspects of Tarkov data:

Core Game Data

achievement - Returns all achievements from Escape From Tarkov
items - Returns comprehensive item data including stats, prices, and properties
ammo - Returns detailed ammunition information including ballistics
armor-materials - Returns armor material properties and durability data

Trading & Economy

barter - Returns all barter trades available from traders
traders - Returns trader information, levels, and offers
flea-market - Returns flea market configuration and fees

Crafting & Hideout

crafts - Returns all crafting recipes and requirements
hideout-stations - Returns hideout station information and upgrades

Quests & Progression

tasks - Returns all quests/tasks with objectives and rewards
quest-items - Returns special quest-only items
skills - Returns player skills information
player-levels - Returns player level progression data
mastering - Returns weapon mastering requirements

Maps & Locations

maps - Returns detailed map information including extracts, spawns, and loot
bosses - Returns boss information including health, equipment, and drops
loot-containers - Returns loot container locations and spawn chances
stationary-weapons - Returns stationary weapon information

System Information

server-status - Returns current Tarkov server status and messages

Installation

Clone this repository
Install dependencies:
```
npm install
```

Configure environment variables (optional):

TARKOV_API_ENDPOINT=https://api.tarkov.dev/graphql
TARKOV_LANG=en

Usage

Running the Server

npm start

The server will start and listen for MCP connections.

Configuration

The server can be configured through environment variables:

TARKOV_API_ENDPOINT - GraphQL API endpoint (default: https://api.tarkov.dev/graphql)
TARKOV_LANG - Language code for localized content (default: en)

Tool Details

achievement

Returns achievement data including:

Achievement name and description
Completion percentages
Rarity information
Side requirements (PMC/SCAV)

items

Returns comprehensive item data including:

Basic properties (name, description, size, weight)
Market prices and trends
Item properties specific to type (weapons, armor, consumables, etc.)
Trading information (barters, cash offers)
Quest usage
Crafting recipes

ammo

Returns ammunition data including:

Ballistic properties (damage, penetration, accuracy)
Armor damage and fragmentation
Recoil and velocity modifiers
Tracer information

barter

Returns barter trade information including:

Required items and quantities
Reward items and quantities
Trader and level requirements
Task unlock requirements

traders

Returns trader information including:

Trader levels and requirements
Available barters and cash offers
Reputation levels and bonuses
Insurance and repair rates

tasks

Returns quest/task data including:

Objectives and requirements
Rewards (items, experience, trader standing)
Prerequisites and unlock conditions
Map-specific information

maps

Returns detailed map information including:

Spawn points and extracts
Loot container and loose loot locations
Boss spawn information
Hazards and special zones
Key requirements

crafts

Returns crafting recipe data including:

Required materials and quantities
Produced items
Crafting station and level requirements
Crafting duration

hideout-stations

Returns hideout station information including:

Upgrade requirements (items, skills, trader levels)
Station bonuses and effects
Crafting capabilities
Construction time and costs

API Reference

All tools return data in JSON format directly from the tarkov.dev GraphQL API. The data structure follows the GraphQL schema definitions.

Error Handling

The server handles various error conditions:

Network connectivity issues
API rate limiting
Invalid GraphQL queries
Missing or malformed data

Development

Project Structure

src/
├── config/          # Configuration management
├── logger/          # Logging utilities
├── tools/           # MCP tool implementations
│   └── items/       # Individual tool modules
│       ├── achievements/
│       ├── ammo/
│       ├── barter/
│       └── ...
└── server.js        # Main MCP server

Adding New Tools

Create a new directory under src/tools/items/
Implement loader.js with GraphQL query
Implement index.js with tool definition
Add to src/tools/items/index.js exports

Code Style

The project uses:

ESLint for code linting
Prettier for code formatting

Run formatting and linting:

npm run format
npm run lint

Contributing

Fork the repository
Create a feature branch
Make your changes
Run tests and linting
Submit a pull request

License

MIT License - see LICENSE file for details.

Acknowledgments

tarkov.dev for providing the comprehensive Tarkov API
Model Context Protocol for the MCP specification
The Escape From Tarkov community for data validation and feedback

Support

For issues and questions:

Check the tarkov.dev API documentation
Open an issue on this repository
Join the community discussions