mcp-steam 0.1.7

MCP server for Steam gaming library, achievements, stats, and store search

mcp-steam

MCP server for Steam, focused on gaming library management, achievements, stats, and store discovery. 20 tools designed for use with Claude and other LLM agents.

Prerequisites

• Python 3.14+
• uv
• A Steam Web API Key
• Your Steam ID (numeric, up to 17 digits)

Setup

1. Get Your Steam API Key

1. Go to the Steam Web API Key page
2. Sign in with your Steam account
3. Register a domain name (any name works for personal use)
4. Note your API key

2. Find Your Steam ID

Your Steam ID is the numeric identifier in your profile URL. If your profile URL is https://steamcommunity.com/profiles/76561198012345678, your Steam ID is 76561198012345678.

If you use a custom URL (e.g., /id/username), use a Steam ID finder to look up the numeric ID.

3. Install

cd mcp-steam
uv sync

4. Configure Environment Variables

Set these before running the server:

export STEAM_API_KEY="your_api_key"
export STEAM_ID="your_steam_id"

5. Test the Connection

uv run mcp-steam

The server verifies your API key and Steam ID on startup by fetching your player summary.

Claude Desktop / Claude Code Configuration

Add to your MCP server config. If installed from PyPI:

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

Or if running from a local clone:

{
  "mcpServers": {
    "steam": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-steam", "run", "mcp-steam"],
      "env": {
        "STEAM_API_KEY": "your_api_key",
        "STEAM_ID": "your_steam_id"
      }
    }
  }
}

Tools

User Resolution

Tool	Parameters	Description
resolve_vanity_url	vanity_name	Convert a custom profile URL name to a 64-bit Steam ID.

Library

Tool	Parameters	Description
get_owned_games	sort_by="playtime", limit=50	Your game library with playtime. Sort by playtime, recent, or name.
get_recently_played	limit=10	Games played in the last 2 weeks.

Game Info

Tool	Parameters	Description
get_game_details	app_id	Store page info: description, price, genres, metacritic, platforms.
search_games	query, limit=10	Search the Steam store.
get_current_players	app_id	Live concurrent player count for a game.
get_game_schema	app_id	Achievement and stat definitions for a game.
get_app_reviews	app_id, review_type="all", limit=10	User reviews with recommendation, playtime, and helpfulness.
get_package_details	package_id	Bundle/package pricing, included apps, and platforms.

Achievements & Stats

Tool	Parameters	Description
get_achievements	app_id	Your achievement progress with global rarity percentages.
get_player_stats	app_id	Game-specific stats (kills, deaths, etc.).
get_global_achievement_stats	app_id	Global unlock percentages for all achievements.

Wishlist

Tool	Parameters	Description
get_wishlist	limit=50	Your wishlist sorted by priority, with prices and discounts.

News

Tool	Parameters	Description
get_game_news	app_id, count=5	Recent news and updates for a game.

Profile

Tool	Parameters	Description
get_player_summary	steam_id=""	Profile summary. Accepts Steam ID or vanity name; defaults to you.
get_friend_list	steam_id=""	Friends list. Accepts Steam ID or vanity name; defaults to you.
get_player_bans	steam_id=""	VAC, community, game, and trade ban status. Defaults to you.
get_steam_level	steam_id=""	Steam level for a player. Defaults to you.

Store Discovery

Tool	Parameters	Description
get_featured_games	(none)	Currently featured and on-sale games.
get_featured_categories	(none)	Top Sellers, New Releases, Specials, Coming Soon, and more.

Steam Web API Notes

• API key security: Your config file contains your Steam API key. Never commit it to version control or share it publicly.
• Rate limits: The Steam Web API has undocumented rate limits. If you hit them, the server will return a rate limit error.
• Profile visibility: Some tools require your Steam profile to be public (achievements, game stats). Library data works regardless.
• Game stats availability: Not all games expose stats through the API. get_player_stats will return an error for unsupported games.
• Wishlist access: Wishlist data requires your profile's wishlist to be public.

Development

uv run mcp-steam              # Run the server
uv run ruff check src/       # Lint
uv run ruff format src/      # Format
uv run pyright src/          # Type check

Pre-commit Hooks

This project uses lefthook for pre-commit checks. Install with brew install lefthook (or see other install methods), then:

lefthook install