Steam MCP Server

Overview Schema Source Related Servers Discussions Admin

Get player profile

get_player_summary

Read-only

Retrieve a Steam player's profile by SteamID64: display name, online state, country, account age, level, and current game. Works for private profiles; country, age, and game need a public profile.

Instructions

Get a player's profile by SteamID64: display name, online state, country, account age, Steam level (a separate lookup that degrades to null on failure, independently of profile privacy), and the game they're currently in. found:false here means exactly one thing — no account with that SteamID64 — since this tool reads private profiles fine. Requires STEAM_API_KEY, but works even for a private profile (visibility reports 'private') — country, account age and the current game only populate when the profile is public. For VAC/game/trade ban status instead, use get_player_bans.

Input Schema

Name	Required	Description	Default
`steamid`	No	17-digit SteamID64. Omit to use the STEAM_ID configured on the server. Convert a vanity/custom URL name with resolve_vanity_url first.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv0.14.0Sep 27, 2026

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "found": {
-        "const": false,
-        "type": "boolean"
-      },
-      "reason": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "found",
-      "reason"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avatar": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "country": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "created": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "found": {
-        "const": true,
-        "type": "boolean"
-      },
-      "in_game": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "level": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "profile_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "real_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "state": {
-        "enum": [
-          "offline",
-          "online",
-          "busy",
-          "away",
-          "snooze",
-          "looking to trade",
-          "looking to play"
-        ],
-        "type": "string"
-      },
-      "steamid": {
-        "type": "string"
-      },
-      "visibility": {
-        "enum": [
-          "public",
-          "private"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "found",
-      "name",
-      "real_name",
-      "state",
-      "visibility",
-      "country",
-      "level",
-      "created",
-      "in_game",
-      "profile_url",
-      "avatar"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "found": {
+        "const": false,
+        "type": "boolean"
+      },
+      "reason": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "found",
+      "reason"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avatar": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "country": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "created": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "found": {
+        "const": true,
+        "type": "boolean"
+      },
+      "in_game": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "level": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "profile_url": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "real_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "state": {
+        "enum": [
+          "offline",
+          "online",
+          "busy",
+          "away",
+          "snooze",
+          "looking to trade",
+          "looking to play"
+        ],
+        "type": "string"
+      },
+      "steamid": {
+        "type": "string"
+      },
+      "visibility": {
+        "enum": [
+          "public",
+          "private"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "found",
+      "name",
+      "real_name",
+      "state",
+      "visibility",
+      "country",
+      "level",
+      "created",
+      "in_game",
+      "profile_url",
+      "avatar"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedv0.13.1Aug 17, 2026

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "found": {
-        "const": false,
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "found"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avatar": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "country": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "created": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "found": {
-        "const": true,
-        "type": "boolean"
-      },
-      "in_game": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "level": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "profile_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "real_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "state": {
-        "enum": [
-          "offline",
-          "online",
-          "busy",
-          "away",
-          "snooze",
-          "looking to trade",
-          "looking to play"
-        ],
-        "type": "string"
-      },
-      "steamid": {
-        "type": "string"
-      },
-      "visibility": {
-        "enum": [
-          "public",
-          "private"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "found",
-      "name",
-      "real_name",
-      "state",
-      "visibility",
-      "country",
-      "level",
-      "created",
-      "in_game",
-      "profile_url",
-      "avatar"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "found": {
+        "const": false,
+        "type": "boolean"
+      },
+      "reason": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "found",
+      "reason"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avatar": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "country": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "created": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "found": {
+        "const": true,
+        "type": "boolean"
+      },
+      "in_game": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "level": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "profile_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "real_name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "state": {
+        "enum": [
+          "offline",
+          "online",
+          "busy",
+          "away",
+          "snooze",
+          "looking to trade",
+          "looking to play"
+        ],
+        "type": "string"
+      },
+      "steamid": {
+        "type": "string"
+      },
+      "visibility": {
+        "enum": [
+          "public",
+          "private"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "found",
+      "name",
+      "real_name",
+      "state",
+      "visibility",
+      "country",
+      "level",
+      "created",
+      "in_game",
+      "profile_url",
+      "avatar"
+    ],
+    "type": "object"
+  }
+]

Changed3 schema fields changedv0.12.1Jul 30, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

removedOutput schema / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "found": {
-        "const": false,
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "found"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avatar": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "country": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "created": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "found": {
-        "const": true,
-        "type": "boolean"
-      },
-      "in_game": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "level": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "profile_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "real_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "state": {
-        "type": "string"
-      },
-      "steamid": {
-        "type": "string"
-      },
-      "visibility": {
-        "enum": [
-          "public",
-          "private"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "found",
-      "name",
-      "real_name",
-      "state",
-      "visibility",
-      "country",
-      "level",
-      "created",
-      "in_game",
-      "profile_url",
-      "avatar"
-    ],
-    "type": "object"
-  }
-]

addedOutput schema / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "found": {
+        "const": false,
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "found"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avatar": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "country": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "created": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "found": {
+        "const": true,
+        "type": "boolean"
+      },
+      "in_game": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "level": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "profile_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "real_name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "state": {
+        "enum": [
+          "offline",
+          "online",
+          "busy",
+          "away",
+          "snooze",
+          "looking to trade",
+          "looking to play"
+        ],
+        "type": "string"
+      },
+      "steamid": {
+        "type": "string"
+      },
+      "visibility": {
+        "enum": [
+          "public",
+          "private"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "found",
+      "name",
+      "real_name",
+      "state",
+      "visibility",
+      "country",
+      "level",
+      "created",
+      "in_game",
+      "profile_url",
+      "avatar"
+    ],
+    "type": "object"
+  }
+]

Addedv0.10.2Jul 22, 2026
Removedv0.8.0Jul 17, 2026

Changed2 schema fields changedv0.3.0Jun 30, 2026

changedInput schema / properties / steamid / description

Previous value: -"17-digit SteamID64. Convert a vanity/custom URL name with resolve_vanity_url first."New value: +"17-digit SteamID64. Omit to use the STEAM_ID configured on the server. Convert a vanity/custom URL name with resolve_vanity_url first."

removedInput schema / required
```
Removed value: -[
-  "steamid"
-]
```

First observedv0.1.0Jun 29, 2026

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint and openWorldHint, but the description adds valuable behavioral nuances beyond those: the found:false semantics (no account vs. private), the separate Steam-level lookup that degrades to null, and the visibility-dependent field population. This is far beyond the minimal annotation coverage and gives the agent critical operational expectations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but every sentence earns its place: purpose, field list, found:false clarification, private-profile behavior, prerequisites, and a sibling pointer. Information is front-loaded and there is zero fluff, making it concise despite its length.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's relative simplicity (one optional param), the description covers all essential context: prerequisites (API key), edge cases (private profiles, found:false), field nuances (public-only fields, Steam-level degradation), and an alternative tool. The existence of an output schema means return values don't need explanation, and the description fills in all other gaps adequately.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already provides 100% coverage for the single parameter 'steamid' with a clear description (17-digit pattern, omission fallback, and vanity resolution hint). The tool description adds no additional parameter-level meaning, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific verb 'Get' and resource 'player's profile', enumerating the exact fields (display name, online state, country, account age, Steam level, current game). It also distinguishes itself from the sibling get_player_bans by explicitly noting the ban-status alternative, so an agent can easily select the right tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives explicit guidance: it mentions the required STEAM_API_KEY, clarifies that it works on private profiles, notes which fields only populate for public profiles, and explicitly directs to get_player_bans for ban status. This provides strong when-to-use and alternative tool routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.