steam-mcp 1.0.0

Read-only Steam MCP server (bring-your-own-key) for friends, games, playtime, achievements, sales, reviews, and live player counts.

Steam MCP

A read-only Model Context Protocol server for the public Steam Web API and storefront. It lets any MCP-compatible AI client (Claude Desktop, Claude Code, etc.) answer questions about Steam — your friends, games, playtime and achievements, plus account-independent things like sales, reviews, ratings, live player counts, and patch notes.

Bring your own key (BYOK): each user supplies their own free Steam Web API key via an environment variable. Nobody logs in, and no credentials pass through this server beyond the key you set yourself.

---

What it can answer

Account / profile (needs a public profile):

• "Who's on my Steam friends list, and who's online right now?"
• "Which of my friends own Helldivers 2 — and who's playing it right now?"
• "It's game night — what co-op games do my online friends and I all own?"
• "What's my most-played game, and how many hours?"
• "Which achievements am I still missing in Hollow Knight?"
• "What are my career stats in Team Fortress 2?"
• "What are my rarest achievements in Hollow Knight?"
• "What's my Steam level?" / "Does this account have any VAC bans?"
• "What's on my wishlist, and is any of it on sale right now?"
• "Analyze my library — what's my backlog and what have I abandoned?"
• "Based on what I play most, what new games should I check out?"

Account-independent (works for any game, no SteamID needed):

• "Is Baldur's Gate 3 any good? What's its review score?"
• "What's on sale on Steam right now?" / "What are the current top sellers and new releases?"
• "How many people are playing Counter-Strike 2 this minute?"
• "What was in the latest Dota 2 update?"
• "How much does Hades II cost and what genres is it?"
• "What DLC does Cities: Skylines have, and is any of it on sale?"
• "Is Elden Ring a soulslike? What are its community tags?"
• "Find co-op roguelikes under $20 that are well-reviewed."
• "Should I buy Hades II right now — and how are its recent reviews trending?"
• "Recommend games like Hollow Knight that I don't already own."

---

Tools

Tool	What it returns	Needs key?
steam_resolve_vanity_url	Vanity name / profile URL → SteamID64	yes
steam_get_player_summary	Status (Online/Away/In-Game…), current game, for 1–100 users	yes
steam_get_friend_list	Friends enriched with name + live status	yes
steam_find_friends_who_own	Which friends own (or are playing) a game — "who can I play X with"	yes
steam_plan_coop_night	Co-op games the host + friends all own, ranked by owners, with who's online now	yes
steam_get_owned_games	Owned games with total/recent hours (sortable)	yes
steam_analyze_library	Backlog, playtime distribution, abandoned games across a whole library	yes
steam_get_recently_played_games	Last-2-weeks playtime	yes
steam_get_steam_level	Steam community level	yes
steam_get_player_bans	VAC / game / community / economy bans	yes
steam_get_player_achievements	Per-game unlocked vs locked achievements	yes
steam_get_game_schema	A game's full achievement/stat definitions	yes
steam_get_global_achievement_percentages	Achievement rarity (global %)	no
steam_get_user_game_stats	A user's in-game stats (kills, wins, distance…) for a game	yes
steam_get_rarest_unlocks	A player's rarest achievement unlocks in a game (by global rarity)	yes
steam_search_apps	Game title → appid (+ price)	no
steam_discover	Find/recommend games by tag, price, sale, platform — optionally personalized to a user's taste (excludes games they own)	no*
steam_should_i_buy	Buying brief — price, lifetime + recent reviews (trend), tags, Metacritic, and your taste match	no*
steam_recommend	Recommend games like a seed game or your taste, with the shared tags as the "why"	no*
steam_get_app_details	Full store details — play modes/co-op, controller, DLC, languages, requirements, Metacritic	no
steam_get_dlc	A game's DLC, with live prices and what's on sale	no
steam_get_app_tags	A game's top community tags (Souls-like, Roguelike, Cozy…)	no
steam_get_app_reviews	Lifetime verdict, +/- counts, sample reviews; optional recent (last-N-days) score via review_filter='recent'	no
steam_get_featured_specials	Games currently on sale (regional)	no
steam_get_store_highlights	Top sellers, new releases, or coming soon	no
steam_get_wishlist	A user's wishlist, with live prices + what's on sale	yes
steam_get_player_badges	Badges + the XP breakdown behind a Steam level	yes
steam_get_package_details	Package/bundle price + included games	no
steam_compare_players	Shared games between two users, with playtime	yes
steam_get_current_players	Live concurrent player count	no
steam_get_app_news	Recent news / patch notes	no

Every tool supports response_format: "markdown" (default, human-readable) or "json" (structured), and all are annotated readOnlyHint: true. Tools that read localized text (steam_get_app_details, steam_search_apps, steam_get_app_reviews, steam_get_player_achievements, …) accept a language parameter — a Steam language name like english, french, german, or schinese (default english).

* steam_discover, steam_should_i_buy, and steam_recommend need no key for the store data; their personalization (passing a steamid to use a user's library/taste) requires a key and a public profile.

Prompts & resources

Beyond tools, the server ships prompts (guided one-click flows that orchestrate the tools) and resources (reference Steam entities by URI):

• Prompts: what_should_i_play, is_it_worth_buying, plan_game_night, steam_deals, game_overview.
• Resources: steam://app/{appid} (store details) and steam://user/{steamid} (profile + live status).

Recent reviews: Steam's API only exposes a lifetime review summary — there is no "last 30 days" field. So steam_get_app_reviews with review_filter='recent' computes that score itself by paginating the newest reviews within day_range days (default 30). For games with a very high volume of recent reviews it counts up to ~600 and marks the result sampled: true.

---

Setup

1. Get a free Steam Web API key

Visit https://steamcommunity.com/dev/apikey, sign in, register a domain (any domain you control works; localhost is commonly used for personal keys), and copy the key. Usage is governed by the Steam Web API Terms of Use.

2. Install

git clone https://github.com/Sarg338/steam-mcp.git
cd steam-mcp
pip install -e .          # or: pip install -r requirements.txt

Requires Python 3.10+.

3. Add it to your MCP client

The server reads the key from the STEAM_API_KEY environment variable.

Claude Desktop — edit claude_desktop_config.json (%APPDATA%\Claude\ on Windows, ~/Library/Application Support/Claude/ on macOS):

{
  "mcpServers": {
    "steam": {
      "command": "python",
      "args": ["-m", "steam_mcp.server"],
      "env": { "STEAM_API_KEY": "YOUR_KEY_HERE" }
    }
  }
}

Claude Code (CLI):

claude mcp add steam --env STEAM_API_KEY=YOUR_KEY_HERE -- python -m steam_mcp.server

If you installed with pip install -e ., you can use the steam-mcp console script as the command instead of python -m steam_mcp.server.

Restart your client and the Steam tools appear.

---

Versioning & stability

steam-mcp follows Semantic Versioning. As of 1.0, the following are the stable public surface — they won't change without a major (2.0) release:

• Tool names and their input parameters (names, types, whether required, defaults)
• JSON output fields (response_format: "json") — names, types, and structure
• Prompt names/arguments and resource URI templates (steam://app/{appid}, steam://user/{steamid})
• Core semantics: read-only, bring-your-own-key, prices in cents / playtime in minutes, and errors returned as strings

Within a major version, minor releases may add tools, prompts, resources, optional parameters, and JSON fields; patch releases are bug fixes only. The Markdown output wording, internal implementation, caching behavior, and which Steam endpoints back a given tool may change at any time and are not part of the contract.

---

License

MIT. Not affiliated with Valve. "Steam" is a trademark of Valve Corporation.