@pvpwire/mcp-server

@pvpwire/mcp-server

MCP server for PVPWire: competitive-gaming data for AI agents.

Structured game-mechanics datasets that no other API serves, plus live player and viewer signal, news, and game-economy snapshots.

A thin, typed, sanitized front door over pvpwire.com/api/*. Zero game logic lives here.

Install

Add to your MCP client config (Claude Desktop, etc.):

{
  "mcpServers": {
    "pvpwire": {
      "command": "npx",
      "args": ["-y", "@pvpwire/mcp-server"],
      "env": {}
    }
  }
}

Every free tool works with no auth and no key. Paid tools read a PVPWIRE_TOKEN bought with USDC.

Game data

30 datasets, 7,096 entries, served inside a disclaimer envelope carrying data_version, game_patch, license, and upstream attribution where one is owed. Diablo 2 is independently compiled and verified against at least two sources; Path of Exile and Diablo 3 are compiled with attribution to community sources, with re-expression into PVPWire's own vocabulary in progress; PlanetSide 2 comes from the official Daybreak Census API under Daybreak's published third-party permission; Warzone 2100 is derived from the GPL-2.0 release in which the original publisher open-sourced the game data itself; Xonotic comes from Team Xonotic's own GPL-3.0 balance files; Quake (1996) is compiled from id Software's own GPL-2.0 source; Angband is derived from its GPL-2.0 data tables (PVPWire elects the GPL branch of its dual licence); Diablo 4 aspects are independently compiled from published references, cross-verified against two sources, no game files touched. Sourcing methods for every dataset are published in writing at /api/methods.

d2    runewords, cube-recipes, breakpoints, uniques, set-items, sets, weapon-innates
poe   uniques, keystones, skill-gems
d3    legendary-items, sets
d4    aspects
ps2   weapons
wz2100 weapons, bodies, propulsion, structures, research, templates
xonotic weapons, player
quake  weapons, armor, items, movement
angband ego-items, artifacts, objects, monster

• list_game_datasets: the full roster with entry counts. Start here.
• search_game_data: find an item, skill, or effect by text across every dataset.
• get_game_dataset: pull a whole table, paged.

Live signal and news

• get_game_players: Steam players, Twitch viewers, and IGDB metadata for one of 119 tracked games. Titles that are not on Steam (League of Legends, Fortnite, Valorant) report Twitch and IGDB.
• get_trending_games: ranked list of what is being played right now, fused from Twitch viewers and Steam players.
• get_gaming_news: ranked competitive-gaming news, with source filter and digest mode.
• get_economy_snapshot: latest daily market snapshot for osrs or ffxiv.
• find_pvpwire_data: plain-language discovery of the right endpoint.

Paid tools

• get_economy_arbitrage: ranked arbitrage over a tracked economy. Free preview daily; full=true returns the ranked, receipt-backed verdict.

Paid with a prepaid credit token bought in USDC on Base or Solana, AFTA-certified: every paid call returns an Ed25519-signed receipt, and no-charge paths are enforced in code rather than promised. See https://pvpwire.com/developers/agent-payments.

Develop

npm install
npm run build
npm test

Not affiliated with or endorsed by the game publishers whose data is referenced. Game-mechanics data is independently compiled. MIT licensed.