Tarkov MCP Server

# Tarkov MCP Tools Reference This document provides a complete reference for all available tools in the Tarkov MCP server. ## Quick Reference | Tool Name | Description | Returns | | -------------------- | ------------------ | --------------------------------------- | | `achievement` | Game achievements | Achievement data with completion stats | | `ammo` | Ammunition data | Ballistic properties and stats | | `armor-materials` | Armor materials | Material properties and durability | | `barter` | Barter trades | Trading requirements and rewards | | `bosses` | Boss information | Boss stats, equipment, and loot | | `crafts` | Crafting recipes | Recipes, requirements, and stations | | `flea-market` | Flea market info | Market configuration and fees | | `hideout-stations` | Hideout stations | Station upgrades and bonuses | | `items` | All items | Comprehensive item database | | `loot-containers` | Loot containers | Container locations and loot tables | | `maps` | Map information | Detailed map data with extracts | | `mastering` | Weapon mastering | Mastery requirements and bonuses | | `player-levels` | Player levels | Level progression and XP requirements | | `quest-items` | Quest items | Special quest-only items | | `server-status` | Server status | Current game server status | | `skills` | Player skills | Skill definitions and effects | | `stationary-weapons` | Stationary weapons | Fixed weapon placements | | `tasks` | Quests/Tasks | Quest objectives and rewards | | `traders` | Traders | Trader levels, offers, and requirements | ## Detailed Tool Descriptions ### achievement **Purpose**: Retrieve all game achievements with completion statistics **Returns**: Array of achievements with: - Name and description - Completion percentages (adjusted and raw) - Rarity classification - Side requirements (PMC/SCAV) - Hidden status ### ammo **Purpose**: Get detailed ammunition statistics and ballistic data **Returns**: Array of ammunition with: - Ballistic properties (damage, penetration, accuracy) - Armor damage and fragmentation chance - Velocity and recoil modifiers - Tracer information and colors - Weight and stack size ### armor-materials **Purpose**: Retrieve armor material properties for damage calculations **Returns**: Array of materials with: - Destructibility values - Repair degradation ranges - Explosion resistance - Repair kit compatibility ### barter **Purpose**: Get all barter trades available from traders **Returns**: Array of barter trades with: - Required items and quantities - Reward items and quantities - Trader and level requirements - Task prerequisites - Buy/sell limits ### bosses **Purpose**: Retrieve boss information including stats and equipment **Returns**: Array of bosses with: - Health pools by body part - Equipment loadouts - Possible loot drops - Portrait and poster images ### crafts **Purpose**: Get all crafting recipes and requirements **Returns**: Array of crafting recipes with: - Required materials and quantities - Produced items and quantities - Hideout station requirements - Crafting duration - Unlock conditions ### flea-market **Purpose**: Retrieve flea market configuration and fee structure **Returns**: Flea market data with: - Minimum player level - Fee rates and calculations - Reputation level bonuses - Category-specific fees - Sell restrictions ### hideout-stations **Purpose**: Get hideout station information and upgrade paths **Returns**: Array of stations with: - Upgrade requirements (items, skills, traders) - Station bonuses and effects - Crafting capabilities - Construction times - Volume and capacity ### items **Purpose**: Comprehensive item database with all game items **Returns**: Array of items with: - Basic properties (name, size, weight, value) - Market prices and trends - Type-specific properties (weapon stats, armor class, etc.) - Trading information - Quest usage - Crafting involvement ### loot-containers **Purpose**: Get loot container information and spawn locations **Returns**: Array of containers with: - Container types and capacity - Loot tables and spawn chances - Map locations with coordinates - Relative spawn probabilities ### maps **Purpose**: Detailed map information with tactical data **Returns**: Array of maps with: - Spawn points and extraction zones - Loot container and loose loot locations - Boss spawn information - Hazardous areas - Key requirements - Transit connections ### mastering **Purpose**: Weapon mastering requirements and progression **Returns**: Array of mastery data with: - Weapon categories - Level 2 and Level 3 requirements - Associated weapon lists ### player-levels **Purpose**: Player level progression and XP requirements **Returns**: Array of levels with: - XP requirements per level - Level badge images - Progression milestones ### quest-items **Purpose**: Special quest-only items not found in regular loot **Returns**: Array of quest items with: - Item properties and images - Quest associations - Spawn locations (if applicable) ### server-status **Purpose**: Current game server status and maintenance information **Returns**: Server status with: - General server health - Individual service statuses - Maintenance messages - Status timestamps ### skills **Purpose**: Player skill definitions and mechanics **Returns**: Array of skills with: - Skill names and IDs - Skill categories - Leveling mechanics (where applicable) ### stationary-weapons **Purpose**: Fixed weapon emplacements on maps **Returns**: Array of stationary weapons with: - Weapon types and names - Map locations - Usage requirements ### tasks **Purpose**: All quests and tasks with detailed requirements **Returns**: Array of tasks with: - Task objectives and descriptions - Prerequisites and unlock conditions - Rewards (items, XP, trader standing) - Map requirements - Failure conditions ### traders **Purpose**: Trader information, levels, and available services **Returns**: Array of traders with: - Trader levels and requirements - Available items and barters - Reputation systems - Service rates (insurance, repair) - Reset timers ## Usage Examples All tools are called without parameters and return comprehensive data: ```javascript // Example: Get all achievements const achievements = await mcp.call("achievement"); // Example: Get item data const items = await mcp.call("items"); // Example: Get map information const maps = await mcp.call("maps"); ``` ## Data Freshness All data is retrieved in real-time from the tarkov.dev API, ensuring: - Current market prices - Latest game updates - Real-time server status - Up-to-date quest information ## Language Support All tools support localization through the `TARKOV_LANG` environment variable: - `en` - English (default) - `ru` - Russian - `de` - German - `fr` - French - `es` - Spanish - `zh` - Chinese - And other supported languages ## Error Handling All tools include robust error handling for: - Network connectivity issues - API rate limiting - Invalid responses - Timeout conditions - Data parsing errors ## Performance Considerations - Tools cache responses when appropriate - GraphQL queries are optimized for minimal data transfer - Requests are batched when possible - Rate limiting is respected automatically