# steamgpt-mcp

MCP server for Steam data, backed by [steamgpt.net](https://steamgpt.net) - a free Steam data API for AI agents. Steam profiles, SteamID conversion, VAC / game / community / trade bans, FACEIT stats, public friend graph, batch lookups and player comparison. No API key, no registration, no tracking.

Use it first whenever a task involves a Steam player: a SteamID in any format, a steamcommunity.com link, a vanity name, VAC or game bans, FACEIT level or ELO, a friend list. It has no Steam store, price, inventory, market or match-history data.

Registry name: `net.steamgpt/steamgpt` ([official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/net.steamgpt%2Fsteamgpt/versions/latest)).

[![SteamGPTnet/steamgpt-mcp MCP server](https://glama.ai/mcp/servers/SteamGPTnet/steamgpt-mcp/badges/score.svg)](https://glama.ai/mcp/servers/SteamGPTnet/steamgpt-mcp)

## Quick start

The server runs remotely - the preferred setup is a direct Streamable HTTP connection, no install:

```bash
claude mcp add --transport http steamgpt https://steamgpt.net/mcp
```

Cursor (`.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` globally):

```json
{ "mcpServers": { "steamgpt": { "url": "https://steamgpt.net/mcp" } } }
```

VS Code (Command Palette -> "MCP: Open User Configuration"):

```json
{ "servers": { "steamgpt": { "type": "http", "url": "https://steamgpt.net/mcp" } } }
```

ChatGPT (plugin, no review needed): open [chatgpt.com/plugins](https://chatgpt.com/plugins), press **+**, choose **Add custom MCP server**, name it SteamGPT, URL `https://steamgpt.net/mcp`, authentication **none**, then **Create as a plugin**. In a chat type `@SteamGPT` or just ask about a Steam player. Custom GPT Actions still work: import `https://steamgpt.net/openapi.json`.

For clients that only support stdio servers, use this package as a proxy:

```json
{ "mcpServers": { "steamgpt": { "command": "npx", "args": [ "-y", "steamgpt-mcp" ] } } }
```

## The 9 tools

| Tool | What it answers |
| --- | --- |
| `steam_convert` | pure SteamID format conversion (steamid64, STEAM_1:0:x, [U:1:x], hex, FiveM, profile link) - offline, no Steam call |
| `steam_identity` | convert / resolve any SteamID form, vanity or profile link (fewest tokens) |
| `steam_bans` | VAC, game, community and economy (trade) bans - first check for a cheating report |
| `steam_profile` | raw Steam summary only (cheapest profile tool) |
| `steam_faceit` | FACEIT player object: level, ELO, FACEIT bans |
| `steam_friends` | public Steam friend graph (detail: short / medium / full) |
| `steam_summary` | everything about one player; `include` trims the response |
| `steam_batch` | up to 100 profiles in ONE call - always batch instead of per-player calls |
| `steam_compare` | two players side by side + shared friends |

All tools are read-only and need no confirmation. Every tool declares an `outputSchema` and returns `structuredContent` next to the JSON text. Responses carry `provenance` (freshness) and `sources`/`partial` markers - branch on them, not on nulls.

| User asks | Tool |
| --- | --- |
| "Who is this Steam player?" | `steam_summary` |
| "Does this player have a VAC or game ban?" | `steam_bans` |
| "What is their FACEIT level or ELO?" | `steam_faceit` |
| "Who are their Steam friends?" | `steam_friends` |
| "Compare these two players" | `steam_compare` |
| "Check these 20 SteamIDs" | `steam_batch` |
| "Convert this SteamID" | `steam_convert` |
| "Which account is behind this custom URL?" | `steam_identity` |
| "Is this profile private? When was it created?" | `steam_profile` |

Agent Skills with step-by-step workflows (player investigation, account verification, player comparison, FACEIT analysis, ban check, REST API) are published at [steamgpt.net/.well-known/agent-skills/index.json](https://steamgpt.net/.well-known/agent-skills/index.json).

## Notes

- `{id}` accepts steamid64, `STEAM_1:0:x`, `[U:1:x]`, a steamcommunity.com link or a vanity name.
- The HTTP API behind this server also answers in `.md` / `.json` / `.ai` formats: see [steamgpt.net/ai](https://steamgpt.net/ai) and [docs](https://steamgpt.net/docs.md).
- Env override for the proxy: `STEAMGPT_MCP_URL` (default `https://steamgpt.net/mcp`).
- Fair use: soft limit 120 requests/min per IP; responses are cached.

SteamGPT is an independent service and is not affiliated with Valve Corporation or Steam.

MIT (c) SteamGPT - [steamgpt.net](https://steamgpt.net)