Package Exports

@tmhs/steam-mcp
@tmhs/steam-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@tmhs/steam-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Steam MCP Server

MCP (Model Context Protocol) server for Steam and Steamworks APIs. Provides structured tools for querying Steam store data, player statistics, achievements, workshop items, leaderboards, and player profiles from AI-powered IDEs.

Built as the companion MCP server for the Steam Developer Tools Cursor plugin.

Getting Started

Prerequisites

Node.js 18 or later
npm

Install

git clone https://github.com/TMHSDigital/Steam-MCP.git
cd Steam-MCP
npm install
npm run build

Steam API Key

Some tools require a Steam Web API key. Get one free at steamcommunity.com/dev/apikey.

Set it as an environment variable:

# Bash / macOS / Linux
export STEAM_API_KEY="your_key_here"

# PowerShell
$env:STEAM_API_KEY = "your_key_here"

Or in a .env file:

STEAM_API_KEY=your_key_here

Tools that don't need a key work out of the box with zero configuration.

Usage with Cursor

Add the Steam MCP server to your Cursor MCP settings (.cursor/mcp.json in your project or global settings):

Via npx (recommended):

{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-mcp"],
      "env": {
        "STEAM_API_KEY": "your_key_here"
      }
    }
  }
}

Via local clone:

{
  "mcpServers": {
    "steam": {
      "command": "node",
      "args": ["/absolute/path/to/Steam-MCP/dist/index.js"],
      "env": {
        "STEAM_API_KEY": "your_key_here"
      }
    }
  }
}

Once configured, the tools are available to Cursor's AI agent. Pair with the Steam Developer Tools plugin for the full skill set.

Available Tools (v0.2.0)

No-Auth Tools

These work without an API key:

Tool	Description
`steam.getAppDetails`	Store data: price, description, reviews, tags, platforms, system requirements
`steam.searchApps`	Search for games/apps by name
`steam.getPlayerCount`	Current concurrent player count
`steam.getAchievementStats`	Global achievement unlock percentages
`steam.getWorkshopItem`	Workshop item details (title, description, tags, subscribers)

API Key Tools

These require STEAM_API_KEY to be set:

Tool	Description
`steam.getPlayerSummary`	Player profile: name, avatar, online status
`steam.getOwnedGames`	Game library with playtime data
`steam.queryWorkshop`	Search/browse Workshop items with filters
`steam.getLeaderboardEntries`	Leaderboard scores and rankings (publisher API key + IP allowlist required)
`steam.resolveVanityURL`	Convert vanity URL to 64-bit Steam ID

Planned Tools

Additional Tools (v0.3.0+)

Tool	Description	Auth
`steam.getReviews`	Fetch user reviews with filters	None
`steam.getPriceOverview`	Batch price check across regions	None
`steam.getAppReviewSummary`	Review histogram and summary	None
`steam.getRegionalPricing`	Pricing breakdown by country	None

Write Operations (v0.7.0+)

Tool	Description	Auth
`steam.createLobby`	Create multiplayer lobbies	SDK
`steam.uploadWorkshopItem`	Upload new Workshop items	SDK
`steam.updateWorkshopItem`	Update existing Workshop items	SDK
`steam.setAchievement`	Unlock achievements (dev/test)	SDK
`steam.uploadLeaderboardScore`	Upload leaderboard scores	SDK
`steam.grantInventoryItem`	Grant inventory items (dev/test)	SDK

Steam API Endpoints

Endpoint	Auth
`store.steampowered.com/api/appdetails`	None
`store.steampowered.com/api/storesearch`	None
`ISteamUserStats/GetNumberOfCurrentPlayers/v1`	None
`ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2`	None
`ISteamUser/GetPlayerSummaries/v2`	API key
`IPlayerService/GetOwnedGames/v1`	API key
`ISteamUser/ResolveVanityURL/v1`	API key
`ISteamRemoteStorage/GetPublishedFileDetails/v1`	None
`IPublishedFileService/QueryFiles/v1`	API key
`ISteamLeaderboards/GetLeaderboardEntries/v1`	Publisher key + IP allowlist

Development

npm run dev       # Watch mode with auto-reload
npm run build     # Compile TypeScript to dist/
npm start         # Run the compiled server

See CONTRIBUTING.md for how to add new tools and submit PRs.

Steam Developer Tools - Cursor IDE plugin with 14 skills and 4 rules for Steam/Steamworks development

License

CC BY-NC-ND 4.0 - see LICENSE for details.

@tmhs/steam-mcp