steam-user-mcp
v1.0.4
Published
MCP server for Steam — library inspection, backlog recommendations, and game wishlist. Works alongside itad-mcp and opencritic-mcp.
Maintainers
Readme
steam-mcp
An MCP (Model Context Protocol) server that connects AI assistants to the Steam Web API and storefront services. Enables game library analysis, backlog recommendations based on mood, wishlist evaluation, and storefront searches. Works alongside itad-mcp and opencritic-mcp.
What this does
This server acts as the foundational layer of a 3-server gaming stack:
steam-mcp(this one) — understands your Steam library, playtime, backlog, wishlist, and tastes. It surfaces game AppIDs.opencritic-mcp— takes game names/AppIDs and provides detailed critic scores and reviews.itad-mcp— takes game names/AppIDs and finds the best deals across legitimate storefronts and historical lows.
Example workflow: User: "I want something atmospheric and chill to play tonight."
steam-mcp(recommend_from_library) finds unplayed "Atmospheric" + "Relaxing" games in your backlog.opencritic-mcpvalidates which of those games have great critic scores.- User: "These look great, any of them on sale?"
itad-mcptakes the AppIDs and checks if any are on sale right now.
Wishlist deal check: get_wishlist → take AppIDs → itad-mcp get_historical_low → surface any games at or near their historical low price.
Tools
| Tool | Parameters | Description | Requires API Key? |
|---|---|---|---|
| get_library | steam_id (string, optional)sort ("playtime" | "recent" | "name")filter ("all" | "unplayed" | "played")limit (number, default 50) | Retrieve the user's owned Steam game library with playtime statistics. | Yes |
| get_recently_played | steam_id (string, optional) | Games played in the last 2 weeks. | Yes |
| get_wishlist | steam_id (string, optional)sort ("priority" | "date_added" | "name")limit (number, default 50) | Retrieve the user's Steam wishlist to find interesting games. | Yes |
| get_app_details | appid (number)country_code (string, default 'us') | Full Steam Store metadata for a specific game (description, genres, categories, price, metacritic). | No |
| get_app_reviews | appid (number)filter ("all" | "recent" | "positive" | "negative") | Steam user review sentiment for a game. | No |
| search_games | query (string)limit (number, default 10) | Resolve a game title to a Steam AppID. | No |
| recommend_from_library | steam_id (string, optional)tags (string[])unplayed_only (boolean, default true)limit (number, default 10) | Find games in the user's library that match specified tags/mood. | Yes |
| discover_games | tags (string[])steam_id (string, optional)max_results (number, default 20)country_code (string, default 'us') | Find well-reviewed games on Steam matching specific tags that the user does NOT own. | Optional |
Prerequisites
- Node 18+
- Steam account with a public library
- Steam Web API key
Getting a Steam API Key
- Go to https://steamcommunity.com/dev/apikey
- Log in with your Steam account.
- Enter any domain name (e.g.
localhost). - Click "Register" and copy the generated 32-character API key.
Finding your Steam ID
You can use either your vanity name or your 17-digit SteamID64.
- If your profile URL is
https://steamcommunity.com/id/your_vanity_name/, your Steam ID isyour_vanity_name. - If your profile URL is
https://steamcommunity.com/profiles/76561198012345678/, your Steam ID is76561198012345678.
Make your profile public
For the API to read your library and playtime, your Game Details privacy setting must be Public.
- Go to your Steam Profile -> Edit Profile -> Privacy Settings.
- Set "My Profile" to Public.
- Set "Game details" to Public.
- Set "Inventory" to Public if you want wishlist access.
Installation
Option A: Using npx (Recommended)
Add this to your MCP configuration JSON (mcp_config.json):
{
"mcpServers": {
"steam": {
"command": "npx",
"args": ["-y", "steam-user-mcp"],
"env": {
"STEAM_API_KEY": "your_api_key_here",
"STEAM_ID": "your_vanity_name"
}
}
}
}Note: You can omit the "env" block entirely and place a .env file containing your STEAM_API_KEY and STEAM_ID in the directory where your MCP client runs.
Option B: Clone & Build
git clone https://github.com/brandikun/steam-mcp
cd steam-mcp
npm install
npm run buildThen add this to your MCP config:
{
"mcpServers": {
"steam": {
"command": "node",
"args": ["/path/to/steam-mcp/dist/index.js"],
"env": {
"STEAM_API_KEY": "your_api_key_here",
"STEAM_ID": "your_vanity_name"
}
}
}
}MCP Configuration variables
STEAM_API_KEY(Required): Your 32-character Steam Web API key.STEAM_ID(Optional): The default user to query for library and playtime tools. If not provided, it must be passed per tool call.
Usage with itad-mcp and opencritic-mcp
For the ultimate gaming assistant, combine all three:
{
"mcpServers": {
"steam": {
"command": "npx",
"args": ["-y", "steam-user-mcp"],
"env": { "STEAM_API_KEY": "your_api_key", "STEAM_ID": "your_id" }
},
"itad": {
"command": "npx",
"args": ["-y", "itad-mcp"],
"env": { "ITAD_API_KEY": "your_itad_key" }
},
"opencritic": {
"command": "npx",
"args": ["-y", "opencritic-mcp"],
"env": { "RAPIDAPI_KEY": "your_rapidapi_key" }
}
}
}Troubleshooting
- "No Steam ID provided": You must set
STEAM_IDin your environment or provide it in the tool call. - "Steam API key is required": The
STEAM_API_KEYenvironment variable is missing. - "Vanity URL not found": The Steam ID provided couldn't be resolved. Ensure it's your exact vanity name or a valid SteamID64.
- Library returns empty: Your profile is private. See the "Make your profile public" section above.
- Tags not matching: Steam tags are very specific. The server does its best with fuzzy matching, but if a tag isn't found, try a broader synonym (e.g., "RPG" instead of "Role-playing").
Privacy
Credentials are only read from environment variables. No data is logged or sent anywhere except Steam's own APIs.
License
MIT
