tarkov-data-patterns
Original:🇺🇸 English
Translated
Use this skill when querying Tarkov game data via MCP tools. Provides optimal query patterns, data relationships, and best practices for the tarkov-dev and eft-wiki MCP servers.
6installs
Added on
NPX Install
npx skill4agent add tarkovtracker-org/tarkovtracker tarkov-data-patternsTags
Translated version includes tags in frontmatterSKILL.md Content
View Translation Comparison →Tarkov Data Query Patterns
CRITICAL: No Speculation or Editorializing
NEVER speculate, guess, infer, or make value judgments about game items/mechanics.
Forbidden patterns:
- ❌ "The two halves can likely be combined..."
- ❌ "This item is probably used for..."
- ❌ "These appear to be joke/troll items"
- ❌ "This is a way to throw away money"
- ❌ "Verdict: [any editorial conclusion]"
- ❌ Any value judgment about items being "useless", "worthless", "bad", etc.
Required patterns:
- ✅ Only state facts directly from the API response
- ✅ If data is missing: "The API doesn't show uses for this item. Data may be incomplete."
- ✅ If no crafts/tasks found: "No crafts or tasks found in the API data. Check in-game or wiki for current uses."
- ✅ Acknowledge data limitations: "This information may not reflect recent game updates."
Remember: Missing data ≠ feature doesn't exist. The API may be incomplete.
Data Sources
| Source | Best For | Tools |
|---|---|---|
| tarkov.dev | Stats, numbers, structured data | search_items, get_item, get_tasks, get_boss, get_ammo |
| eft-wiki | Lore, tactics, guides, narrative | search_wiki, get_wiki_page, get_wiki_section |
Response Modes
All tools accept parameter:
mode- concise (default): Paginated, essential fields, bounded output
- full: All data, all fields, complete details
Use for:
concise- Discord bots, public interfaces
- Initial searches before drilling down
- Lists and overviews
Use for:
full- Development and research
- Single-item deep dives
- When user explicitly wants everything
Common Patterns
Finding Items
search_items(query="bitcoin") # Find by name
get_item(id="physical-bitcoin") # Get full details
get_items_by_category(category="keys") # Browse categoryTask Research
get_tasks(trader="Prapor") # All tasks from trader
get_tasks(map="Customs") # Tasks on specific map
get_task(id="Delivery from the Past") # Single task detailsAmmo Comparison
get_ammo(caliber="7.62x39mm") # All ammo for caliber
# Then compare penetration vs damage trade-offsBoss Intel
get_boss(name="Killa") # Stats, health, gear
get_wiki_section("Killa", "Tactics") # Fight strategiesPagination
get_items_by_category(category="weapon", limit=10, offset=0) # First 10
get_items_by_category(category="weapon", limit=10, offset=10) # Next 10Data Relationships
Items ←→ Tasks (required for / rewarded by)
Items ←→ Hideout (crafts, upgrades)
Items ←→ Barters (trade requirements)
Tasks ←→ Traders (quest givers)
Tasks ←→ Maps (where objectives are)
Bosses ←→ Maps (spawn locations)Query Optimization
- Start narrow: Use specific IDs/names before broad searches
- Use filters: trader, map, caliber reduce result sets
- Paginate early: Use limit/offset in concise mode
- Cache results: Don't re-query same data in one session
Error Handling
- Item not found → Try search_items with partial name
- Boss not found → API returns list of valid boss names
- Wiki section missing → Response includes available sections
Caliber Formats
Common caliber strings for :
get_ammo- ,
5.45x39mm,5.56x45mm,7.62x39mm7.62x51mm - ,
9x19mm,9x18mm9x21mm - ,
12.7x55mm,.338 Lapua Magnum.300 Blackout
Category Names
Common categories for :
get_items_by_category- Weapons: ,
assault-rifle,smg,pistol,shotgunsniper-rifle - Gear: ,
armor,helmet,rigbackpack - Items: ,
keys,medical,provisionsbarter