Skip to main content
Glama

steam_get_inventory

Read-only

Retrieve any Steam user's inventory items by SteamID or profile URL. Filter by app (Community items, CS2, TF2, Dota 2) and limit results for a targeted read.

Instructions

List a user's Steam inventory — game items or generic Community items.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
paramsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed15 schema fields changedv1.18.0
    • removedInput schema / $defs / InventoryInput / properties / appid / title
      Removed value: -"Appid"
    • removedInput schema / $defs / InventoryInput / properties / context_id / default
      Removed value: -null
    • removedInput schema / $defs / InventoryInput / properties / context_id / title
      Removed value: -"Context Id"
    • removedInput schema / $defs / InventoryInput / properties / count / title
      Removed value: -"Count"
    • removedInput schema / $defs / InventoryInput / properties / language / title
      Removed value: -"Language"
    • addedInput schema / $defs / InventoryInput / properties / limit
      Added value: +{
      +  "default": 50,
      +  "description": "Max distinct items to list, most-numerous first (1-200); distinct_items always counts all of them.",
      +  "maximum": 200,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • removedInput schema / $defs / InventoryInput / properties / response_format / $ref
      Removed value: -"#/$defs/ResponseFormat"
    • addedInput schema / $defs / InventoryInput / properties / response_format / enum
      Added value: +[
      +  "markdown",
      +  "json"
      +]
    • addedInput schema / $defs / InventoryInput / properties / response_format / type
      Added value: +"string"
    • removedInput schema / $defs / InventoryInput / properties / steamid / default
      Removed value: -null
    • removedInput schema / $defs / InventoryInput / properties / steamid / title
      Removed value: -"Steamid"
    • removedInput schema / $defs / InventoryInput / title
      Removed value: -"InventoryInput"
    • removedInput schema / $defs / ResponseFormat
      Removed value: -{
      -  "description": "Output format for tool responses.",
      -  "enum": [
      -    "markdown",
      -    "json"
      -  ],
      -  "title": "ResponseFormat",
      -  "type": "string"
      -}
    • removedInput schema / title
      Removed value: -"steam_get_inventoryArguments"
    • changedOutput schema / (root)
      Previous value: -{
      -  "properties": {
      -    "result": {
      -      "title": "Result",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "result"
      -  ],
      -  "title": "steam_get_inventoryOutput",
      -  "type": "object"
      -}New value: +null
  2. First observedv1.14.0

TDQS

B3.3/5.0
Behavior3/5

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

The readOnlyHint annotation already conveys that this is a safe read operation, and the description is consistent with that. However, the description adds little beyond the annotation—only noting the two item types. It does not disclose sampling behavior, pagination, or the configurable defaults, which could affect user expectations. Since the annotation covers the core safety aspect, a 3 is acceptable but not standout.

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

Conciseness4/5

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

The description is a single, well-structured sentence that states the core purpose concisely. It is front-loaded and has no filler. The only reason not to give a 5 is that it omits any hint at additional behavior or parameters, but as a pure purpose statement it is both concise and effective.

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

Completeness2/5

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

The tool has seven parameters, no output schema, and the description only covers the bare purpose. It does not explain that output can be markdown or json, that large inventories are sampled rather than fully retrieved, or that default behaviors exist. For a tool with this complexity, the description is incomplete and leaves the agent without important context about what to expect from the tool's execution.

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 description does not mention any parameters, and the context signal indicates 0% coverage of parameters in the description. However, the input schema itself provides extensive descriptions for all seven parameters (appid, count, limit, steamid, language, context_id, response_format), so the schema carries full semantic weight. Per the rubric, baseline 3 is appropriate when the schema is rich and the description adds no redundant detail.

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 identifies the action ('List') and the resource ('a user's Steam inventory'), and additionally distinguishes between the two item categories (game items or generic Community items). This is specific and unambiguous, and no sibling tool appears to overlap with this functionality, so no extra differentiation is needed.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives. It does not mention any conditions, prerequisites, or mention that it should be used for inventory queries specifically. The agent is left to infer usage solely from the tool name and description, which is insufficient for a tool with many siblings.

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