SteamGPT

Use when the user asks who a Steam player is or wants everything known about one account in a single call: Steam summary, Steam ban status (VAC/game/community), SteamID conversions, FACEIT stats and the first 100 friends. include LIMITS the response to the blocks you list: omit it for everything, ["steam"] for the Steam block only (cheapest), ["bans"] for a ban check only, ["faceit","bans"] to drop the friend list; friends_limit caps the friend list (default 100). Responses carry provenance.fresh and sources/partial - branch on them, not on nulls. Do not use for several players (steam_batch) or for a single fact (steam_bans, steam_faceit, steam_convert are cheaper).

Use when the user asks whether a Steam account has a VAC, game, community or trade (economy) ban - the first check for a cheating report or before trusting a player. Returns VACBanned, NumberOfVACBans, NumberOfGameBans, DaysSinceLastBan, CommunityBanned and EconomyBan exactly as Steam reports them; DaysSinceLastBan is 0 both for banned today and never banned. Unresolvable ids or an unavailable upstream return an error result, never guessed data. Do not use for FACEIT bans (steam_faceit).

Use when the user asks about one Steam account itself - nickname, avatar, profile visibility, creation date, online status, current game - and nothing else. Returns the raw GetPlayerSummaries object plus SteamID conversions; cheapest profile tool, data no older than 48 hours, unknown profiles are fetched live from Steam. Private profiles return the public subset of fields (not an error); unresolvable ids return an error result. Do not use for bans, FACEIT or friends (steam_summary or the narrow tools).

Use when the user wants a SteamID converted between formats - steamid64 (dec and hex), STEAM_1:0:x, legacy STEAM_0, [U:1:x], 32-bit account id, steam:hex (FiveM) or the profile URL - starting from any one of them, instantly and offline. CHEAPEST TOOL: prefer it over steam_identity whenever only format conversion is needed. Do not use for vanity names (steamcommunity.com/id/name is not a computable format - use steam_identity) or for profile data (steam_profile).

Use when the user gives a vanity name or a steamcommunity.com/id/ link and the steamid64 behind it is needed, or when a resolved identity is needed in every format without profile data: steamid64, SteamID (STEAM_1:0:x), SteamID3 ([U:1:x]), steam hex, vanity, profile URL. Resolution goes through Steam; unresolvable ids return an error result - never a partial guess. Do not use for pure format conversion of a known id (steam_convert is cheaper) or for profile data (steam_profile).

Use when the user asks who the friends of a Steam player are or needs the friend list for a graph check. Source: the platform snapshot of the public Steam friend graph (cache only, no live Steam call; it can be partial - absence of a friendship is not proof). detail picks token cost: short - steamid64 array, medium - steamid64 + personaname, full - raw Steam objects; use short unless names are needed. Do not use for shared friends of two players (steam_compare).

Use when the user asks how good a CS2 player is on FACEIT - level, ELO, country, nickname - or whether a FACEIT account is banned. Returns the FACEIT player object plus known FACEIT bans; players without a FACEIT account return a result saying so - absence is reported explicitly, never silently. Do not use for Steam (VAC/game) bans (steam_bans) or for match history and per-match stats, which SteamGPT does not have.

Use when the user gives several Steam ids - a match roster, a team, a list of suspects - and wants profiles, FACEIT or ban status for all of them: up to 100 in ONE call, always instead of per-player calls. ids are STRINGS in any computable SteamID format (steamid64, STEAM_1:0:x, STEAM_0:0:x, [U:1:x], hex, steam:hex, a 32-bit account id, a /profiles/ link); never JSON numbers (a 17-digit number loses precision and points at another account); vanity names are not accepted - resolve them with steam_identity first. Players unknown to the platform come back in not_found - fetch those with steam_profile. include adds FACEIT (one query for the batch) and Steam bans (one upstream call) - the cheapest way to review a full roster. Do not use for one player (steam_summary).

Use when the user asks to compare two Steam players, whether two accounts are related or share friends, or for smurf and alt-account hints: identity, account age, visibility, Steam bans, FACEIT and shared friends compared over the full friend lists. HEAVIEST tool - it builds two summaries plus both friend graphs. Do not use for a single player (steam_summary) or for more than two players (steam_batch).