Skip to main content
Glama
Sign In
xbox-mcp

xbox-mcp

by 312-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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

Tool

What it does

Other players?

get_current_game

Online state, device, and the game running right now with rich-presence detail

Yes (gamertag/xuid)

get_recent_games

Recently played games, newest first, with last-played date, devices, and per-title achievement/gamerscore progress

Yes

get_activity

Your screenshots, game clips, and achievement posts, newest first

Self only*

get_profile

Gamertag, gamerscore, account tier, reputation, bio, location

Yes

search_players

Find players by gamertag; returns their XUID for follow-up lookups

Yes

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: chess.com MCP Server

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.

Available Tools

5 tools
get_activityGet recent Xbox activityA
Read-only

Get your recent Xbox activity feed: screenshots, game clips (Game DVR), and achievement posts, most-recent first, each tied to a game and timestamp. Note: only available for your own account (the OpenXBL activity feed is not exposed for other players).

Inputs: limit.

get_current_gameGet currently playing gameA
Read-only

Get what an Xbox player is doing right now: online/offline state, which console or device, and the currently running game with its rich-presence detail. Defaults to your own account; pass a gamertag or xuid for someone else.

Inputs: xuid, gamertag.

get_profileGet Xbox profileA
Read-only

Get an Xbox player's profile: gamertag, gamerscore, account tier, reputation, bio and location. Defaults to your own account; pass a gamertag or xuid for someone else.

Inputs: xuid, gamertag.

get_recent_gamesGet recently played gamesA
Read-only

Get an Xbox player's recently played games, most-recent first, with when each was last played, the device(s) used, and achievement/gamerscore progress in each title. This is the 'what have they been up to' history. Defaults to your own account; pass a gamertag or xuid for someone else.

Inputs: xuid, limit, gamertag.

search_playersSearch Xbox playersA
Read-only

Search for Xbox players by gamertag. Returns matching players with their XUID, gamertag, gamerscore and real name — use this to find the XUID for another player before looking up their profile, current game, or history.

Inputs: gamertag (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.3/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: activity feed, current game, profile, recent games, and player search. No overlap in functionality.

    Naming Consistency4/5

    Four tools follow 'get_' prefix pattern, but 'search_players' deviates slightly. However, all use verb_noun structure, maintaining readability.

    Tool Count5/5

    Five tools is well-scoped for an Xbox profile and activity server, covering essential read operations without bloat.

    Completeness4/5

    Covers profile, activity, current game, recent games, and search. Minor gaps like friends list or achievement details are optional, not critical.

    Resources

    Related MCP Connectors

    Related MCP Servers