# HTTP endpoints

**For:** self-hosters writing reverse proxy rules or network policies. **At the end:** you know every path each server answers, on which port, and whether it goes through your login, opens to anyone, or stays private.

<!-- Generated by tools/manual/generate.py from ENDPOINTS in tools/manual/generate.py, checked against the route code. Edit the source, then run `uv run python tools/manual/generate.py`. tests/test_manual.py fails while this is stale. -->

To set up a proxy: [Put it behind a reverse proxy](https://sam-dumont.github.io/wow-mcp/self-host/reverse-proxy/).

## The full view: `wow-stats ui`, port 8080 (`PORT`)

Your own page. Route it through your login, except the rows that say otherwise.

| Path | Route | What |
|---|---|---|
| `/`, `/app.js`, `/app.css`, `/items.js`, `/fonts/*` | through your login | the page and its files |
| `/api/config`, `/api/chars`, `/api/char`, `/api/journal`, `/api/overview`, `/api/timeline`, `/api/snapshot`, `/api/people`, `/api/loot`, `/api/dungeons`, `/api/gear`, `/api/analysis`, `/api/items`, `/api/plan`, `/api/market`, `/api/prices`, `/api/logsql`, `/api/*` | through your login | the page's JSON answers (`/api/plan` also takes a POST) |
| `/model3d/*`, `/api/model3d`, `/render/<char>.<ext>`, `/icons/<size>/<name>.jpg` | through your login | the 3D view, the armory picture, the item icons |
| `/full/` | through your login | `FULL_DOOR_PATH`: a redirect to `/`, through your login. Empty: off |
| `/healthz` | no login | health check: `200 ok`, no login. Fine to route; probes need no credentials |
| `/ingest` | no login | `POST` from the shipper, with its own password (`INGEST_PASSWORD`). Route it **without** your page login, or the shipper can't get through |

## Extra full-view paths with several people (`WOW_STATE_DIR`)

Only on a shared install. Same port.

| Path | Route | What |
|---|---|---|
| `/start`, `/start/print`, `/start/media/*`, `/settings`, `/account.js`, `/account.css`, `/api/me`, `/api/me/status`, `/api/me/install-code`, `/api/me/settings`, `/api/me/*`, `/api/admin/hosts` | through your login | the start page, settings, and each person's own answers |
| `/admin`, `/admin.css`, `/api/admin/overview` | through your login | the owner's overview ([Admin overview](https://sam-dumont.github.io/wow-mcp/self-host/admin/)); 404 for anyone else |
| `/help`, `/help/`, `/help/help.js`, `/help/help.css` | through your login | the manual for friends: install steps, the page tour, connecting their AI |
| `/install/<code>`, `/privacy`, `/privacy/*` | no login | the install command (the single-use code is the credential) and the privacy page: no login |

## The shipper's auto-update: inside `wow-stats ui`, same port

With one person or several. Route it like `/ingest`, **without** your page login: the shipper sends its upload password.

| Path | Route | What |
|---|---|---|
| `/install/update/shipper` | no login | `GET`, upload password: the shipper's version and each file's sha256, as JSON |
| `/install/update/shipper/<name>` | no login | `GET`, upload password: one of the shipper's files (`wow_stats.py`, the installers) |

## The MCP endpoint: inside `wow-stats ui`, port 8090 (`MCP_PORT`)

Only when `MCP_PUBLIC_URL` is set. Route these to 8090 **without** your page login: the MCP's own tokens protect them. Let cookies through on `/authorize`, `/consent` and `/oauth/callback`, or every login stops at the Approve button.

| Path | Route | What |
|---|---|---|
| `/mcp` | no login | the MCP endpoint (OAuth bearer token) |
| `/authorize`, `/consent`, `/oauth/callback` | no login | the login pages your browser opens |
| `/token`, `/register`, `/revoke` | no login | called by the AI client's servers |
| `/.well-known/oauth-authorization-server`, `/.well-known/oauth-protected-resource`, `/.well-known/oauth-protected-resource/mcp` | no login | discovery |

## The static sites: `wow-stats static`, port 8080 in the container (8081 in the compose kit)

Files only, no login, no cookie. Safe to put on the internet.

| Path | Route | What |
|---|---|---|
| `/`, `/zogzog/`, `/help/` | no login | the public site, the sealed friends' site (`ZOGZOG_PATH`) and the help page (with `HELP_KEY_FILE`) |
| `/healthz` | no login | health check |
| `/js/script.js`, `/api/event` | no login | only with `PLAUSIBLE_DOMAIN`: route these two to your Plausible, nothing else (on the full view's name too, ahead of its login, when the ui has `PLAUSIBLE_DOMAIN`) |

## Never route these from outside

Internal listeners. Keep them on a private network.

| Path | Route | What |
|---|---|---|
| `/bundle`, `/bundles` | never | the static server's upload port (`UPLOAD_PORT`) |
| `/analysis.json`, `/users.json`, `/hosts.json`, `/profile-characters`, `/publisher.json` | never | the full view's share port (`ANALYSIS_SHARE_PORT`); the publisher POSTs its pass to `/publisher.json` |
| `/render`, `/model3d/view`, `/healthz` | never | the renderer, port 8083 |
| `/metrics`, `/healthz` | never | the exporter, port 9464 (`LISTEN_PORT`): its own health only, never Blizzard's data |
| `/select/*`, `/insert/*` | never | VictoriaLogs, port 9428: your events, readable without a login |
