steam-mcp 1.4.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 — 34 tools, 5 prompts, and 2 resources that let any MCP client (Claude Desktop, Claude Code, Cursor, …) answer questions about Steam: your friends, games, playtime, and achievements, plus account-independent things like sales, reviews, live player counts, discovery, recommendations, and co-op planning.

Read-only · official Steam APIs only · bring your own key · open source. Nobody logs in; the only credential is the free Steam Web API key you set yourself, and the server never writes, trades, posts, launches games, or makes purchases.

Quick start

Install uv, get a free Steam Web API key, then:

Claude Code

claude mcp add steam --env STEAM_API_KEY=YOUR_KEY -- uvx steam-mcp

Claude Desktop — download steam-mcp.mcpb from the latest release, open it (Settings → Extensions), and paste your key.

Cursor / Cline / Windsurf and the manual pip setup are under Setup below.

---

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?"
• "What's in my CS2 inventory, and which items are marketable?"

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?"
• "What's the Community Market price of a Field-Tested AK-47 | Redline?"
• "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_get_user_groups	The Steam groups/clans a user is in (name, URL, member count)	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_regional_pricing	A game's price across regions (each in local currency)	no
steam_get_workshop_item	Workshop item metadata (game, tags, subscribers, favorites, views)	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_inventory	A user's inventory — game items or Steam Community items (cards, emoticons…), with tradable/marketable flags	no
steam_get_market_price	Community Market price for an item (lowest/median/24h volume) + type/rarity + CS2 condition	no
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. Markdown is the compact default — ask for json only when you need to parse fields, and prefer the composite tools (steam_should_i_buy, steam_recommend, steam_discover, steam_plan_coop_night) over chaining several calls. 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.

Market prices: steam_get_market_price uses Steam's Community Market endpoints, which are undocumented and tightly rate-limited. Results are cached briefly; an item with no current listings reports its price as unavailable.

---

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

The published package needs no checkout (Python 3.10+):

uvx steam-mcp          # zero-install via uv (recommended)
# or
pip install steam-mcp  # run as: python -m steam_mcp.server

3. Add it to your MCP client

The server reads your key from the STEAM_API_KEY environment variable.

Claude Code

claude mcp add steam --env STEAM_API_KEY=YOUR_KEY -- uvx steam-mcp

Claude Desktop — install steam-mcp.mcpb from the latest release via Settings → Extensions and paste your key.

Everything else (Claude Desktop config, Cursor, Cline, Windsurf, VS Code, …) — drop this block into the client's MCP config file:

{
  "mcpServers": {
    "steam": {
      "command": "uvx",
      "args": ["steam-mcp"],
      "env": { "STEAM_API_KEY": "YOUR_KEY_HERE" }
    }
  }
}

Config locations: Claude Desktop claude_desktop_config.json (%APPDATA%\Claude\ on Windows, ~/Library/Application Support/Claude/ on macOS); Cursor .cursor/mcp.json; Cline cline_mcp_settings.json. Restart the client and the Steam tools appear. Running from a source checkout instead? Use "command": "python", "args": ["-m", "steam_mcp.server"].

---

Security

Read-only, official-Steam-only, and bring-your-own-key. In short:

• Read-only — never writes, trades, posts, launches games, or buys anything.
• Your key stays yours — read from STEAM_API_KEY; never written to disk, logged, cached, or put in output (and redacted from error messages).
• Official hosts only — the request layer refuses any host that isn't api.steampowered.com / store.steampowered.com / steamcommunity.com (SSRF guard), with per-host rate limiting and retry/backoff.
• Typed, validated inputs (extra="forbid"); no data kept between requests beyond a small TTL cache of non-user store data.

Full details and how to report issues are in SECURITY.md.

---

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.