LearnHouse
Build, edit and run courses, learning paths and communities in your LearnHouse academy.
war.app (Warzone) game advisor — games, maps, bonuses, routes, live board, picks, turns and chat
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 12/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Warapp MCP. Follow https://mcp.popnx.com/i/chrischall-warapp-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 20, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Warapp MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "warapp": { "command": "npx", "args": [ "-y", "@chrischall/warapp-mcp" ], "env": { "WARAPP_EMAIL": "your-value", "WARAPP_API_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For WARAPP_API_TOKEN, WARAPP_EMAIL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Warapp MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
WARAPP_EMAIL The email address you sign in to war.app with.Descriptions are as written by the maker.
SettingsDeveloperEdit Config
{
"mcpServers": {
"warapp": {
"command": "npx",
"args": [
"-y",
"@chrischall/warapp-mcp"
],
"env": {
"WARAPP_EMAIL": "your-value",
"WARAPP_API_TOKEN": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Warapp MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Warapp MCP or shows a Warapp MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
WARAPP_WS_PORT fetchproxy bridge concentrator port for the live-game tools. Defaults to the fleet-shared 37149.WARAPP_ENV_FILE Optional dotenv file with WARAPP_EMAIL / WARAPP_API_TOKEN (default ~/.config/warapp-mcp/.env)WARAPP_TRANSPORT How the live-game tools reach war.app: auto (default, direct when a session is linked else the browser bridge), direct, or fetchproxy.WARAPP_SESSION_FILE Where the linked direct-transport session is stored (default /session.json). Local-only, file mode 0600.WARAPP_PLAYER_RECORD The 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_PROFILE Opponent 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 finis…Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Warapp MCP yet
Warapp MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Warapp MCP
B · Others in Games, sports, food & learning that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a Warapp MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WARAPP_EMAIL) · Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Warapp MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user warapp --env WARAPP_EMAIL=your-value --env WARAPP_API_TOKEN=your-value -- npx -y @chrischall/warapp-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For WARAPP_API_TOKEN, WARAPP_EMAIL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Warapp MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
WARAPP_EMAIL The email address you sign in to war.app with.Descriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user warapp --env WARAPP_EMAIL=your-value --env WARAPP_API_TOKEN=your-value -- npx -y @chrischall/warapp-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Warapp MCP listed as connected
Use Warapp MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Warapp MCP or shows a Warapp MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
WARAPP_WS_PORT fetchproxy bridge concentrator port for the live-game tools. Defaults to the fleet-shared 37149.WARAPP_ENV_FILE Optional dotenv file with WARAPP_EMAIL / WARAPP_API_TOKEN (default ~/.config/warapp-mcp/.env)WARAPP_TRANSPORT How the live-game tools reach war.app: auto (default, direct when a session is linked else the browser bridge), direct, or fetchproxy.WARAPP_SESSION_FILE Where the linked direct-transport session is stored (default /session.json). Local-only, file mode 0600.WARAPP_PLAYER_RECORD The 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_PROFILE Opponent 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 finis…Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Warapp MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WARAPP_EMAIL) · Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Warapp MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "warapp": { "command": "npx", "args": [ "-y", "@chrischall/warapp-mcp" ], "env": { "WARAPP_EMAIL": "your-value", "WARAPP_API_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For WARAPP_API_TOKEN, WARAPP_EMAIL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Warapp MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
WARAPP_EMAIL The email address you sign in to war.app with.Descriptions are as written by the maker.
In the Warapp MCP settings, WARAPP_API_TOKEN, WARAPP_EMAIL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Warapp MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Warapp MCP or shows a Warapp MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
WARAPP_WS_PORT fetchproxy bridge concentrator port for the live-game tools. Defaults to the fleet-shared 37149.WARAPP_ENV_FILE Optional dotenv file with WARAPP_EMAIL / WARAPP_API_TOKEN (default ~/.config/warapp-mcp/.env)WARAPP_TRANSPORT How the live-game tools reach war.app: auto (default, direct when a session is linked else the browser bridge), direct, or fetchproxy.WARAPP_SESSION_FILE Where the linked direct-transport session is stored (default /session.json). Local-only, file mode 0600.WARAPP_PLAYER_RECORD The 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_PROFILE Opponent 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 finis…Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Warapp MCP key (create it on the maker’s site) · 1 setting(s) to fill in (WARAPP_EMAIL) · Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Warapp MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "warapp": { "type": "stdio", "command": "npx", "args": [ "-y", "@chrischall/warapp-mcp" ], "env": { "WARAPP_EMAIL": "your-value", "WARAPP_API_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For WARAPP_API_TOKEN, WARAPP_EMAIL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Warapp MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
WARAPP_EMAIL The email address you sign in to war.app with.Descriptions are as written by the maker.
In the Warapp MCP settings, WARAPP_API_TOKEN, WARAPP_EMAIL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Warapp MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Warapp MCP or shows a Warapp MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
WARAPP_WS_PORT fetchproxy bridge concentrator port for the live-game tools. Defaults to the fleet-shared 37149.WARAPP_ENV_FILE Optional dotenv file with WARAPP_EMAIL / WARAPP_API_TOKEN (default ~/.config/warapp-mcp/.env)WARAPP_TRANSPORT How the live-game tools reach war.app: auto (default, direct when a session is linked else the browser bridge), direct, or fetchproxy.WARAPP_SESSION_FILE Where the linked direct-transport session is stored (default /session.json). Local-only, file mode 0600.WARAPP_PLAYER_RECORD The 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_PROFILE Opponent 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 finis…Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user warapp --env WARAPP_EMAIL=your-value --env WARAPP_API_TOKEN=your-value -- npx -y @chrischall/warapp-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"warapp": {
"command": "npx",
"args": [
"-y",
"@chrischall/warapp-mcp"
],
"env": {
"WARAPP_EMAIL": "your-value",
"WARAPP_API_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"warapp": {
"command": "npx",
"args": [
"-y",
"@chrischall/warapp-mcp"
],
"env": {
"WARAPP_EMAIL": "your-value",
"WARAPP_API_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"warapp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chrischall/warapp-mcp"
],
"env": {
"WARAPP_EMAIL": "your-value",
"WARAPP_API_TOKEN": "your-value"
}
}
}
}WARAPP_EMAIL required envWARAPP_API_TOKEN secret required envWARAPP_WS_PORT envWARAPP_ENV_FILE envWARAPP_TRANSPORT envWARAPP_SESSION_FILE envWARAPP_PLAYER_RECORD envWARAPP_PLAYER_PROFILE envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026
The registry name was verified with the GitHub account chrischall, which owns the repo
Code last changed today
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked yet
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/chrischall-warapp-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: WARAPP_API_TOKEN
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed today, and the latest version (0.6.0) reached the registry today.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Build, edit and run courses, learning paths and communities in your LearnHouse academy.
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft serves real save game data and expert game knowledge to AI assistants.
| This one Warapp MCP | LearnHouse | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | Yes | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 5/5 | 4/4 | 3/3 | 4/4 | 3/4 |
| License | MIT | AGPL-3.0 | AGPL-3.0 | MIT | MIT | Apache-2.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
war.app (Warzone) game advisor MCP server for Claude. It reads your games through war.app's per-player GameFeed API and helps you think about them: players and settings, the map's bonuses and chokepoints, the board, and routes between territories. Through your signed-in war.app browser tab it also lists your games (the ones waiting on you first), scouts an opponent (their record and your head-to-head), reads the live board (including the pick phase, where GameFeed has none), your territory picks and your cards, plans your turn, tells you when a game is waiting on you (war.app's push notifications), and — only after you confirm — submits picks, commits your turn's orders (card plays included) and posts game chat.
This project was developed and is maintained by AI (Claude Code). Use at your own discretion.
{
"mcpServers": { "warapp": { "command": "npx", "args": ["-y", "@chrischall/warapp-mcp"], "env": { "WARAPP_EMAIL": "you@example.com", "WARAPP_API_TOKEN": " " } } } }
warapp_healthcheck to confirm war.app accepts the credentials.| Variable | Required | |
|---|---|---|
WARAPP_EMAIL | yes | The email address you sign in to war.app with. |
WARAPP_API_TOKEN | yes | Your API token from https://war.app/API/GetAPIToken. |
WARAPP_ENV_FILE | no | A dotenv file to read the two above from (default ~/.config/warapp-mcp/.env). Values already in the environment win. |
WARAPP_WS_PORT | no | The fetchproxy bridge port (default 37149, shared by the whole fetchproxy fleet and ContextMint Bridge). Override it only for local testing, or when a host injects a per-registration port. |
WARAPP_TRANSPORT | no | How the live-game tools reach war.app: auto (default — try the chrome-less direct transport when a session is linked, else the browser bridge), direct (only direct), or fetchproxy (only the browser bridge, today's behaviour). See Direct transport. |
WARAPP_SESSION_FILE | no | Where the linked direct-transport session is stored (default /session.json). Local-only; a full-account credential, kept at file mode 0600. Its directory is made 0700, so name a file in a directory of its own. |
WARAPP_AUTH_TOKEN | no | Hosted only, set by mcp-host: the war.app session cookie its sign-in captured (a full-account credential, held in memory, never stored or shown). Ignored on a local install. See Direct transport. |
WARAPP_STATS | no | 1 turns on warapp_map_stats on a local install (off by default; always off when hosted). It then fetches finished ladder games — at most max_new_games a call, one request a second — and caches them under /stats/. |
WARAPP_PLAYER_PROFILE | no | Opponent profiling (on by default, locally and hosted; off turns it off): what each opponent did on the turns your boards showed, as counts (gameplay only — no name, chat or time of play), kept per game under /profiles/games/ for warapp_profile_opponents, and folded when a game finishes into name-free cross-game counts (profiles/players.json, keyed by a salted hash shared with the player record; profiles/population.json, pooled by format and for AI seats) that fade per game. It also switches off the end-of-game pass (#312): once per finished game you played, its history read once and kept name-free at /finished/ .json (its boards included, owners by the same salted hash, no clock; at most 500), then folded into the profiles, into a per-map record ( /maps-record/ .json: outcomes, your start and income curve, the winner's start and pace after turns 4 and 8) and into the lessons ( /lessons.json: how each game was lost, when your income went flat, and the tracked estimates against the true incomes, aggregates only). |
WARAPP_DEBUG | no | Truthy logs the bridge's role and lifecycle to stderr. |
MCP_DATA_DIR | no | Where this server keeps its local state (default ~/.config/warapp-mcp): the downloaded war.app client bundle (bundle/), GameFeed maps (maps/), each planned game's name-free settings (games/), the board history (boards/) and the rest of its per-game records. A host with persistent state sets it. |
MCP_CONFIRM_MODE | no | What a write does on a client that cannot show a confirmation prompt: ask-user (default), auto or refuse. See Confirming writes. |
The server starts without credentials and reports what is missing on the first call that needs them.
GameFeed has no list of your games, no player profiles, no live board during the pick phase, no picks and no way to post chat. Those come from war.app's own web client (its protocol and its profile pages), which is authenticated by your browser's war.app session rather than by the API token. So the live-game tools — warapp_my_games, warapp_scout_player, warapp_get_live_board, warapp_get_my_picks, warapp_plan_picks, warapp_submit_picks, warapp_plan_turn, warapp_check_plan, warapp_track_opponents, warapp_locate_opponents, warapp_profile_opponents, warapp_get_team, warapp_team_brief, warapp_submit_turn, warapp_uncommit_turn, warapp_leave_game, warapp_send_chat, warapp_wait_for_turn, and warapp_analyze_board when GameFeed sends no board — relay each request through your signed-in war.app tab with the fetchproxy bridge. They need:
WARAPP_EMAIL.The server never sees your war.app password or session cookies; the tab makes the request and hands back the answer. The tools decode the board with war.app's own client code: the first live call downloads the current client bundle (ujs.js) from War.app's CDN and caches it per version under the data directory. Nothing from war.app is shipped in this package.
~/.fetchproxy/identity/. After that, warapp_healthcheck reports the bridge's status too.More than one browser? Approve the code in the browser that holds your war.app session. Paired the wrong one? Revoke warapp-mcp in the ContextMint Bridge popup, run fpx trust clear warapp-mcp (from @fetchproxy/cli), restart the server and pair again.
By default the live-game tools relay every request through your signed-in war.app tab. You can instead let them talk to war.app directly, with no browser involved, by linking your session once:
warapp_link_session (confirm-gated). With a signed-in war.app tab paired to the bridge, it captures your war.app session cookie once and stores it on this machine only ( /session.json, file mode 0600; WARAPP_SESSION_FILE overrides the path).WARAPP_TRANSPORT=auto (the default), every live call is a plain server-side HTTPS request carrying that session — no Chrome tab needed, including the turn-notification socket. If the session expires, the tools automatically fall back to the browser bridge for the rest of the session and warapp_session_status tells you to run warapp_link_session again.warapp_session_status reports whether a session is linked, how old it is, and which transport is active. warapp_healthcheck reports the same.
Security. The stored session cookie is a full-account credential — anything your war.app
account can do, it can do. It never leaves this machine (it is sent only to war.app), is never
logged, and is never shown in a tool result. Use direct mode only on a machine you control;
rmthe session file (or let it expire) to unlink.
Hosted (mcp-host). A hosted server never stores a session file and never offers warapp_link_session. It rides the direct transport only when mcp-host signed it in to war.app: the host captures war.app's session cookie into the per-user secret WARAPP_AUTH_TOKEN (your war.app password is asked once at sign-in and never stored), and the server holds it in memory, falling back to the browser bridge if it stops working. warapp_session_status then reports linked: true with linkedBy: "host" (no capture time or age), and a signed-out session says to use Sign in on the connection, or to reconnect it; a paired war.app tab works meanwhile. Without that token the hosted server uses the browser bridge, as before. (The war.app sign-in mcp-host runs is docs/examples/warapp-auth-flow.json, one password page; its capture calls warapp_sign_in, a hosted-only tool that signs in to war.app once and returns the session cookie to the host. mint.yaml declares it as auth.flow; a registration that does not carry it uses the browser bridge.) The trade-off: once a registration carries the flow, every new connection needs one successful war.app password sign-in. Any failed sign-in, not only a wrong password (a captcha, a war.app outage, a network fault), ends the login with no connection, and may clear the fields already entered; an account that signs in through Facebook, with no war.app password, cannot connect. The browser bridge stays the fallback only for a connection made before the flow was added and for a session that expires later. Locally WARAPP_AUTH_TOKEN is ignored.
| Tool | |
|---|---|
warapp_healthcheck | Check that war.app accepts your email and API token; report the active transport and whether a direct session is linked. |
warapp_my_games | Your games (through your signed-in tab), games waiting on you first: state, turn, players and who has committed, and waitingOnYou; surrenderPending per game (another player's surrender still pending, owedByMe true when it waits on your acceptance; read from the game details, unverified live; null when not read, never "none") and as a top-level count of games where one waits on you, which come first too (compact only). Finished games only with include_finished; listed (games war.app returned) and complete (false, with a warning, when the list may be partial). Each call also runs the end-of-game pass (as warapp_get_game does) on up to two of your finished games not yet processed, newest first, among your newest 250 finished games (endOfGame: processed, pending). view: compact / brief. |
| warapp_list_open_games | Open games you could join, from war.app's Open Games page: pace, boot time, seats, team or not, entry fee, cards, rules (One Army Must Stand Guard on or off among them), plannerGaps (rules the planner does not model yet; a guard-off game is not one: the planner keeps a second line, raids and retakes with the guard off, a raid or retake sized for its owner's deploy there), joined: true on games you already hold a seat in, lottery (from the data, never the name: true for a map of at most four territories — its size read from GameFeed only for lobbies with base income 0 and overridden bonuses, at most five a call, or from a map already cached — null for that settings shape w