mcp-steam-scout

An MCP server that gives AI assistants like Claude access to your Steam, PlayStation, Xbox, Epic Games Store, and GOG libraries and current gaming trends to make personalised game recommendations weighted by actual playtime.

Built with the official MCP Go SDK.

Steam API Terms of Service: This project uses the Steam Web API. You must obtain your own API key from steamcommunity.com/dev/apikey and comply with the Steam Web API Terms of Use. Your Steam profile must be set to public for library lookups to work.

Features

Merged library (always available — calls all configured platforms)

Tool	What it does
`get_merged_library`	Aggregates your library across all configured platforms, normalizes titles (strips edition suffixes, trademark symbols, platform/year tags), merges matching games into single entries with `totalPlaytimeMinutes` summed across platforms, and sorts ascending — unplayed games first

Steam tools

Tool	What it does
`resolve_steam_id`	Converts a Steam vanity username to a numeric Steam ID
`get_library`	Fetches your owned Steam games including playtime data

Trending (no setup required)

Tool	What it does
`get_trending`	Returns currently trending games from Steam and GOG with price and rank data

PlayStation tools (optional)

Enabled automatically when PSN_NPSSO is set.

Tool	What it does
`get_psn_library`	Fetches your PS5 and PS4 games including playtime data

Xbox tools (optional)

Enabled automatically when XBOX_REFRESH_TOKEN is set.

Tool	What it does
`get_xbox_library`	Fetches your Xbox game library via Xbox Live

Epic Games Store tools (optional)

Enabled automatically when EPIC_REFRESH_TOKEN is set.

Tool	What it does
`get_epic_library`	Fetches your Epic Games Store library (playtime data is not available from Epic's API)

GOG tools (optional)

Enabled automatically when GOG_REFRESH_TOKEN is set.

Tool	What it does
`get_gog_library`	Fetches your GOG library including playtime data

What you can do with it

Ask Claude things like:

"Recommend me something to play based on my cross-platform library and what's trending."

"What are the top trending games on Steam right now? Which ones match my playstyle based on my library?"

"What unplayed games do I already own across all my platforms?"

"I mostly play strategy games — are any trending games in that genre worth trying?"

Claude chains the tools together automatically, cross-references your playtime with current trends, and gives you personalised recommendations.

Quick start

Prerequisites

A Steam Web API key — free and instant to register
Node.js 18+ (for the npx install method) or Go 1.22+ (to build from source)

Install

via npx (recommended — no build step):

npx @opdude/mcp-steam-scout

The binary is downloaded automatically on first run.

via Go (build from source):

git clone https://github.com/opdude/mcp-steam-scout
cd mcp-steam-scout
go tool task build
# binary is written to ./bin/mcp-server

Find your Steam Username or ID

You can configure the server using your Steam vanity username or your 17-digit Steam ID. You can:

Look up your Steam ID manually at steamid.io
Ask Claude to run resolve_steam_id with your vanity username to find your ID.

Get your PSN NPSSO token (optional)

The NPSSO token is a session token issued by Sony after you log in to PlayStation. Sony does not provide an official API key — this is the standard method used by PSN tools and libraries.

Log in to playstation.com in your browser and make sure you are fully signed in.
Visit https://ca.account.sony.com/api/v1/ssocookie — while logged in, this returns a JSON response containing your npsso value.
Copy the npsso value from the response and set it as PSN_NPSSO in your MCP client config.

Token expiry: The NPSSO token expires after a period of inactivity. If PSN tools return authentication errors, repeat the steps above to get a fresh token.

Get your Xbox refresh token (optional)

The Xbox refresh token is obtained via Microsoft's device code flow. Run the setup tool directly (no clone needed):

go run github.com/opdude/mcp-steam-scout/cmd/setup-xbox@latest

The tool will:

Display a URL and code
Prompt you to visit the URL and enter the code
Wait for authentication
Print the XBOX_REFRESH_TOKEN value to add to your config

Age verification: The first Xbox library fetch may trigger an age verification prompt. If you encounter errors, visit account.microsoft.com/profile to complete age verification.

Get your Epic Games Store refresh token (optional)

The Epic refresh token is obtained via an OAuth flow. Run the setup tool directly (no clone needed):

go run github.com/opdude/mcp-steam-scout/cmd/setup-epic@latest

The tool will:

Display a URL to visit and log in
After login, you'll be redirected to a URL containing an authorization code
Paste the code into the CLI
Print the EPIC_REFRESH_TOKEN value to add to your config

Privacy policy / EULA acceptance: If authentication fails with corrective_action_required, first visit store.epicgames.com in your browser, log in, and accept any pending privacy policy or terms of service prompts. Then try the setup tool again.

Get your GOG refresh token (optional)

The GOG refresh token is obtained via an OAuth flow. Run the setup tool directly (no clone needed):

go run github.com/opdude/mcp-steam-scout/cmd/setup-gog@latest

The tool will:

Display a URL to visit and sign in
After login, you'll be redirected to a URL containing an authorization code
Paste the code into the CLI
Print the GOG_REFRESH_TOKEN value to add to your config

Playtime data: GOG playtime requires an additional web session cookie. Set GOG_COOKIE to the value of the gog-al cookie from your browser after logging into gog.com. Without it, your GOG library is still available but without playtime data.

Install the skills

This repo includes skills that give AI agents cross-platform game recommendation awareness and help with setup.

Claude Code

/plugin marketplace add opdude/mcp-steam-scout
/plugin install game-selector@mcp-steam-scout
/plugin install mcp-steam-scout-setup@mcp-steam-scout

Other tools (opencode, Claude.ai, etc.)

npx skills add https://github.com/opdude/mcp-steam-scout --skill game-selector
npx skills add https://github.com/opdude/mcp-steam-scout --skill mcp-steam-scout-setup

The skills make the agent automatically check all your configured platforms and trending games when you ask for a recommendation.

Validate your PSN NPSSO (optional)

A validation tool is included to test your NPSSO token before adding it to your config (no clone needed):

go run github.com/opdude/mcp-steam-scout/cmd/setup-psn@latest --npsso <your_npsso_token>

The tool authenticates with Sony and fetches your game library, confirming the token is valid.

Client configuration

You must set STEAM_API_KEY, and at least one of STEAM_ID or STEAM_USERNAME. All other tokens are optional and enable additional platform tools when set.

Claude Code / Claude Desktop (npx)

{
  "mcpServers": {
    "mcp-steam-scout": {
      "command": "npx",
      "args": ["-y", "@opdude/mcp-steam-scout"],
      "env": {
        "STEAM_API_KEY": "your_steam_api_key_here",
        "STEAM_USERNAME": "your_steam_username_here",
        "PSN_NPSSO": "your_npsso_token_here",
        "XBOX_REFRESH_TOKEN": "your_xbox_refresh_token_here",
        "EPIC_REFRESH_TOKEN": "your_epic_refresh_token_here",
        "GOG_REFRESH_TOKEN": "your_gog_refresh_token_here",
        "GOG_COOKIE": "your_gog_al_cookie_value_here"
      }
    }
  }
}

Claude Code / Claude Desktop (local binary)

{
  "mcpServers": {
    "mcp-steam-scout": {
      "command": "/path/to/bin/mcp-server",
      "env": {
        "STEAM_API_KEY": "your_steam_api_key_here",
        "STEAM_USERNAME": "your_steam_username_here",
        "PSN_NPSSO": "your_npsso_token_here",
        "XBOX_REFRESH_TOKEN": "your_xbox_refresh_token_here",
        "EPIC_REFRESH_TOKEN": "your_epic_refresh_token_here",
        "GOG_REFRESH_TOKEN": "your_gog_refresh_token_here",
        "GOG_COOKIE": "your_gog_al_cookie_value_here"
      }
    }
  }
}

Environment variables

Variable	Required	Description
`STEAM_API_KEY`	Yes	Steam Web API key from steamcommunity.com/dev/apikey
`STEAM_ID`	One of these	Your 17-digit numeric Steam ID
`STEAM_USERNAME`	One of these	Your Steam vanity username
`PSN_NPSSO`	No	NPSSO token from the `npsso` cookie on playstation.com. Enables PSN tools when set.
`XBOX_REFRESH_TOKEN`	No	Xbox refresh token from the device code flow. Enables Xbox tools when set. Obtain via `go run github.com/opdude/mcp-steam-scout/cmd/setup-xbox@latest`.
`EPIC_REFRESH_TOKEN`	No	Epic refresh token from the OAuth flow. Enables Epic Games Store tools when set. Obtain via `go run github.com/opdude/mcp-steam-scout/cmd/setup-epic@latest`.
`GOG_REFRESH_TOKEN`	No	GOG refresh token from the OAuth flow. Enables GOG tools when set. Obtain via `go run github.com/opdude/mcp-steam-scout/cmd/setup-gog@latest`.
`GOG_COOKIE`	No	GOG web session cookie (`gog-al`). Enables playtime data for GOG library. Get the value from your browser cookies after logging into gog.com.

Development

Running tasks

All tasks are managed as Go tools — no separate installation required:

go tool task build   # build the binary to ./bin/mcp-server
go tool task test    # run all tests
go tool task lint    # run golangci-lint

Project layout

cmd/mcp-server/     MCP server entry point
cmd/setup-epic/     Epic OAuth flow setup tool
cmd/setup-gog/      GOG OAuth flow setup tool
cmd/setup-psn/      PSN NPSSO validation tool
cmd/setup-xbox/     Xbox device code flow setup tool
internal/adapter/   Steam, PSN, Xbox, Epic, and GOG API clients
internal/scraper/   Steam and PlayStation Store trending scrapers
internal/mcp/       MCP tool definitions
pkg/models/         shared data structures
npm/                npx wrapper and binary installer

Releasing

Binaries are built and distributed via GoReleaser. The npm package at npm/ downloads the appropriate platform binary from GitHub Releases on install.

Name		Name	Last commit message	Last commit date
Latest commit History 54 Commits
.claude-plugin		.claude-plugin
.claude/skills/mcp-steam-scout-setup		.claude/skills/mcp-steam-scout-setup
.github		.github
cmd		cmd
internal		internal
npm		npm
pkg/models		pkg/models
plugins		plugins
.env.example		.env.example
.gitignore		.gitignore
.golangci.yml		.golangci.yml
.goreleaser.yml		.goreleaser.yml
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
Taskfile.yml		Taskfile.yml
go.mod		go.mod
go.sum		go.sum

Navigation Menu

Repository files navigation

mcp-steam-scout

Contents

Features

Merged library (always available — calls all configured platforms)

Steam tools

Trending (no setup required)

PlayStation tools (optional)

Xbox tools (optional)

Epic Games Store tools (optional)

GOG tools (optional)

What you can do with it

Quick start

Prerequisites

Install

Find your Steam Username or ID

Get your PSN NPSSO token (optional)

Get your Xbox refresh token (optional)

Get your Epic Games Store refresh token (optional)

Get your GOG refresh token (optional)

Install the skills

Claude Code

Other tools (opencode, Claude.ai, etc.)

Validate your PSN NPSSO (optional)

Client configuration

Claude Code / Claude Desktop (npx)

Claude Code / Claude Desktop (local binary)

Environment variables

Development

Running tasks

Project layout

Releasing

About

Releases

Packages

Used by

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

mcp-steam-scout

Contents

Features

Merged library (always available — calls all configured platforms)

Steam tools

Trending (no setup required)

PlayStation tools (optional)

Xbox tools (optional)

Epic Games Store tools (optional)

GOG tools (optional)

What you can do with it

Quick start

Prerequisites

Install

Find your Steam Username or ID

Get your PSN NPSSO token (optional)

Get your Xbox refresh token (optional)

Get your Epic Games Store refresh token (optional)

Get your GOG refresh token (optional)

Install the skills

Claude Code

Other tools (opencode, Claude.ai, etc.)

Validate your PSN NPSSO (optional)

Client configuration

Claude Code / Claude Desktop (npx)

Claude Code / Claude Desktop (local binary)

Environment variables

Development

Running tasks

Project layout

Releasing

About

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages