xbox-mcp

An MCP server that knows what you (or any Xbox player) are playing right now and what you've been up to lately. Backed by the unofficial OpenXBL Xbox Live API.

Tools

Every player-facing tool takes an optional gamertag (or xuid). Omit both to target your own account. Pass a gamertag and the server resolves it to an XUID via /search (cached), then queries that player.

* The OpenXBL activity feed is only exposed for the authenticated account.

Related MCP server: mcp-server-steam

Configuration

One environment variable:

• OPENXBL_API_KEY — your OpenXBL API key from https://xbl.io (sign in with your Microsoft/Xbox account, then copy the key from the dashboard).

The key never leaves the server; MCP clients only ever see tool results.

Run locally

npm install
npm run build
OPENXBL_API_KEY=xxxx node dist/index.js   # speaks MCP over stdio

Or for development without a build step:

OPENXBL_API_KEY=xxxx npm run dev

Notes

• The OpenXBL free tier allows ~150 requests/hour. Each tool call is 1-2 requests (gamertag lookups add one). Bursty history sweeps can hit the limit.

• Minutes-played and the cross-title recent-achievement feed are not reliably exposed by the API, so they are intentionally omitted. Per-title achievement progress is surfaced through get_recent_games instead.