Skip to main content

MCP server for Steam & SteamDB data — game search, player counts, price tracking, and more

Project description

SteamDB MCP Server

A Model Context Protocol (MCP) server for querying Steam and SteamDB-style data. Search games, check live player counts, view price info, browse top charts, and more — all from your AI assistant.

PyPI GitHub License: MIT

✅ Features

Tool Description
search_games Search the Steam store by keyword
get_game_details Full app info: price, genres, release date, screenshots, etc.
get_player_count Live concurrent players for any Steam app
get_top_games Top games by current player count
get_player_history 24h peaks + ownership stats
get_price_history Current Steam price overview
get_wishlist Fetch a public Steam wishlist
get_user_library Owned games + playtime (requires Steam API key)
get_recent_news Latest news articles for a game

🚀 Quick Start

Option 1: uvx (recommended — fastest, no install)

# Run directly without installing
uvx steamdb-mcp

Option 2: pip install

pip install steamdb-mcp
steamdb-mcp

Option 3: From source

git clone https://github.com/irfanmaulanaak/steamdb-mcp.git
cd steamdb-mcp
uv pip install -e .
steamdb-mcp

⚙️ MCP Client Configuration

Add to your MCP client config (Claude Desktop, Hermes, Cursor, etc.):

Using uvx (recommended)

{
  "mcpServers": {
    "steamdb": {
      "command": "uvx",
      "args": ["steamdb-mcp"]
    }
  }
}

Using pip

{
  "mcpServers": {
    "steamdb": {
      "command": "steamdb-mcp"
    }
  }
}

With Steam API Key (optional)

Only needed for get_user_library:

{
  "mcpServers": {
    "steamdb": {
      "command": "uvx",
      "args": ["steamdb-mcp"],
      "env": {
        "STEAM_API_KEY": "your_steam_api_key_here"
      }
    }
  }
}

Get a free Steam API key at: https://steamcommunity.com/dev/apikey

📜 Hermes Agent Config

For Hermes Agent users, add to ~/.hermes/config.yaml:

mcp_servers:
  steamdb:
    command: "uvx"
    args: ["steamdb-mcp"]
    env:
      STEAM_API_KEY: ""

🔧 Example Usage

Once connected, ask your AI assistant things like:

  • "Search for Forza Horizon 6 on Steam"
  • "How many players are currently playing Elden Ring?"
  • "What's the price of Crimson Desert?"
  • "Show me the top 10 games on Steam right now"
  • "Get recent news for Counter-Strike 2"

📦 Data Sources

This server combines multiple public APIs:

  • Steam Web API — player counts, news, user libraries
  • Steam Store API — game details, search, prices
  • SteamSpy — top charts, ownership estimates, tags

Note: SteamDB itself does not have an official public API. This server provides SteamDB-style data by aggregating the above sources.

📝 Requirements

  • Python 3.10+
  • (Optional) A Steam Web API key for get_user_library

📄 License

MIT — see LICENSE

👍 Contributing

Issues and PRs welcome! https://github.com/irfanmaulanaak/steamdb-mcp/issues

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

steamdb_mcp-0.1.0.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

steamdb_mcp-0.1.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file steamdb_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: steamdb_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for steamdb_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 8db8347182978fb76430b83bc53ddef3efaa6deaa26e8bf2fc9ad55a8c32d14c
MD5 1753d8d93d03f4a3dc8849fc850ba5d5
BLAKE2b-256 015abfc25062c740190eb58c7cdecfdd5434e615ac3fe44e067d8e67b1ea22bc

See more details on using hashes here.

Provenance

The following attestation bundles were made for steamdb_mcp-0.1.0.tar.gz:

Publisher: publish.yml on irfanmaulanaak/steamdb-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file steamdb_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: steamdb_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for steamdb_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f4e5885200df3a143d0b84a2e88b31da991258f3dd2548ec4fc9bf7764f113b1
MD5 d271b70a7d3154dc1f638f4e06219175
BLAKE2b-256 e9e6ec76a89f717c729085a462ae58ac82a679dc04372fd86a7c72f7accbaed7

See more details on using hashes here.

Provenance

The following attestation bundles were made for steamdb_mcp-0.1.0-py3-none-any.whl:

Publisher: publish.yml on irfanmaulanaak/steamdb-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page