Skip to content
MCP server

Warapp MCP

war.app (Warzone) game advisor — games, maps, bonuses, routes, live board, picks, turns…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.5.0
Listing updated
1 day ago

About Warapp MCP

Warapp MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

war.app (Warzone) game advisor — games, maps, bonuses, routes, live board, picks, turns and chat

Install

Run in a terminal

claude mcp add warapp-mcp --env WARAPP_EMAIL='<WARAPP_EMAIL>' --env WARAPP_API_TOKEN='<WARAPP_API_TOKEN>' -- npx -y @chrischall/warapp-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "warapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/warapp-mcp"
      ],
      "env": {
        "WARAPP_EMAIL": "<WARAPP_EMAIL>",
        "WARAPP_API_TOKEN": "<WARAPP_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "warapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/warapp-mcp"
      ],
      "env": {
        "WARAPP_EMAIL": "<WARAPP_EMAIL>",
        "WARAPP_API_TOKEN": "<WARAPP_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "warapp-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/warapp-mcp"
      ],
      "env": {
        "WARAPP_EMAIL": "<WARAPP_EMAIL>",
        "WARAPP_API_TOKEN": "<WARAPP_API_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "warapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/warapp-mcp"
      ],
      "env": {
        "WARAPP_EMAIL": "<WARAPP_EMAIL>",
        "WARAPP_API_TOKEN": "<WARAPP_API_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "warapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/warapp-mcp"
      ],
      "env": {
        "WARAPP_EMAIL": "<WARAPP_EMAIL>",
        "WARAPP_API_TOKEN": "<WARAPP_API_TOKEN>"
      }
    }
  }
}

Configuration

  • WARAPP_EMAILThe email address you sign in to war.app with.Required
  • WARAPP_API_TOKENYour war.app API token, from https://war.app/API/GetAPIToken while signed in.Required
  • WARAPP_WS_PORTfetchproxy bridge concentrator port for the live-game tools. Defaults to the fleet-shared 37149.
  • WARAPP_ENV_FILEOptional dotenv file with WARAPP_EMAIL / WARAPP_API_TOKEN (default ~/.config/warapp-mcp/.env)
  • WARAPP_TRANSPORTHow the live-game tools reach war.app: auto (default, direct when a session is linked else the browser bridge), direct, or fetchproxy.
  • WARAPP_SESSION_FILEWhere the linked direct-transport session is stored (default <data dir>/session.json). Local-only, file mode 0600.
  • WARAPP_PLAYER_RECORDThe name-free cross-game record of how other players kept truces (salted hashes, no names). On by default; set off to turn it off.
  • WARAPP_PLAYER_PROFILEOpponent profiling: counts of what each opponent did on the turns your boards showed (gameplay only, no names or chat), kept per game, and folded name-free (salted-hash keys) into counts across finished games. On by default; set off to turn it off.

Pricing

Open source

Warapp MCP FAQ

Is Warapp MCP free?

Yes. Warapp MCP is open source, so you can use and self-host it for free.

How do I add Warapp MCP to Claude Code?

Run this command in your terminal: claude mcp add warapp-mcp --env WARAPP_EMAIL='<WARAPP_EMAIL>' --env WARAPP_API_TOKEN='<WARAPP_API_TOKEN>' -- npx -y @chrischall/warapp-mcp