[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Steam game details](https://spiral.ai/integrations/codex/steam-game-details)

# How to Use Steam game details in Codex

Returns the store record for one Steam app. Use it to investigate a title after discovery, with more context than a search result or chart entry.

|  |  |
| --- | --- |
| Model | Steam game details |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Steam game details in Codex

- Use Steam game details for https://store.steampowered.com/app/620/Portal_2/ and populate this project's game detail screen with the returned store information.
- Use Steam game details to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Steam game details and tell me what changed since last week.
- Check Steam game details and summarize what you find in three bullet points.
- Pull the newest data from Steam game details and give me the result as a table.

## How to set up Steam game details in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Steam game details**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "store-steampowered-com/games/game_details",
    "input": {
      "appid": 1
    }
  }'
```

Then paste one of the prompts above: Codex finds Steam game details on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Steam game details tools and prices

- [Steam store · Game details](https://spiral.ai/tools/alexandria/store-steampowered-com/games/game_details) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | Steam store app URL, e.g. https://store.steampowered.com/app/1245620/ELDEN_RING/. Alternative to appid. |
| appid | 1 to 4294967295 | — | Steam application id, e.g. 1245620 for ELDEN RING. |
| country |  | US | ISO 3166-1 alpha-2 storefront country (cc); prices and currency follow it. Default US. Pattern: ^[A-Za-z]{2}$. |
| language |  | english | Steam language name for localized text, e.g. english, german, french. Default english. Pattern: ^[a-z]{2,20}$. |

## What can you do with Steam game details in Codex?

Build a Steam research feature that turns returned game data into useful comparisons. A coding agent can add the relevant results to your project's screens, reports, or stored observations.

### Build a game shopping shortlist

Discover free games or deals, resolve exact titles, and compare store records, current offers, and recurring review themes before choosing what to play.

### Prepare a weekly Steam editorial brief

Find stories in featured listings, deals, and charts. Identify the games, then add store context, current offers, news, review themes, and player activity to the reporting shortlist.

### Research competing game launches

Resolve competing titles and compare their store positioning, offers, announcements, review themes, and activity. Check sales and player rankings as separate measures of demand.

### Compare regional storefront discovery

Compare the games surfaced through browsing, featured listings, search, and sales rankings in selected storefront countries. Inspect store records and regional offers for the titles that differ.

### Choose games for a gaming club

Start with free listings, deals, featured games, or active titles. Resolve the shortlist and compare store information, current offers, reviews, and player activity for the club's next session.

### Maintain a Steam market dashboard

Combine discovery lists and charts with title-level store information, offers, news, reviews, and activity. Save observations over time to show changes since collection began.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Steam game details in other agents

- [Amp](https://spiral.ai/integrations/amp/steam-game-details)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/steam-game-details)
- [Claude](https://spiral.ai/integrations/claude-desktop/steam-game-details)
- [Claude Code](https://spiral.ai/integrations/claude-code/steam-game-details)
- [Cline](https://spiral.ai/integrations/cline/steam-game-details)
- [Cursor](https://spiral.ai/integrations/cursor/steam-game-details)
- [Devin](https://spiral.ai/integrations/devin/steam-game-details)
- [dots](https://spiral.ai/integrations/dots/steam-game-details)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/steam-game-details)
- [Gemini](https://spiral.ai/integrations/gemini/steam-game-details)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/steam-game-details)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/steam-game-details)
- [goose](https://spiral.ai/integrations/goose/steam-game-details)
- [Grok](https://spiral.ai/integrations/grok/steam-game-details)
- [Grok Build](https://spiral.ai/integrations/grok-build/steam-game-details)
- [Hermes](https://spiral.ai/integrations/hermes/steam-game-details)
- [Instinct](https://spiral.ai/integrations/instinct/steam-game-details)
- [Manus](https://spiral.ai/integrations/manus/steam-game-details)
- [Muse](https://spiral.ai/integrations/muse/steam-game-details)
- [Muse Code](https://spiral.ai/integrations/muse-code/steam-game-details)
- [n8n](https://spiral.ai/integrations/n8n/steam-game-details)
- [Notion](https://spiral.ai/integrations/notion/steam-game-details)
- [OpenClaw](https://spiral.ai/integrations/openclaw/steam-game-details)
- [opencode](https://spiral.ai/integrations/opencode/steam-game-details)
- [Perplexity](https://spiral.ai/integrations/perplexity/steam-game-details)
- [Raycast](https://spiral.ai/integrations/raycast/steam-game-details)
- [VS Code](https://spiral.ai/integrations/vscode/steam-game-details)
- [Windsurf](https://spiral.ai/integrations/windsurf/steam-game-details)
- [Zapier](https://spiral.ai/integrations/zapier/steam-game-details)

## More Codex guides

- [Steam free games and deals](https://spiral.ai/integrations/codex/steam-free-games-and-deals)
- [Steam game news](https://spiral.ai/integrations/codex/steam-game-news)
- [Steam featured games](https://spiral.ai/integrations/codex/steam-featured-games)
- [Steam game prices](https://spiral.ai/integrations/codex/steam-game-prices)
- [Steam current player count](https://spiral.ai/integrations/codex/steam-current-player-count)
- [Steam game reviews](https://spiral.ai/integrations/codex/steam-game-reviews)

## Questions about Steam game details in Codex

**Can Codex use Steam game details?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Steam game details like any built-in tool.

**How much does Steam game details cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use Steam game details in Codex?**

No. Spiral runs Steam game details on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Steam game details in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Steam game details runs?**

Steam game details runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Where does the Steam data come from?**

Alexandria reads Steam's own storefront and Web API JSON endpoints. The offering covers store listings, game news, reviews, charts, and live player counts.

**Does Steam search show every title?**

Steam explicitly reports that titles can be excluded based on content preferences. Search results therefore have a coverage boundary and should not be presented as a complete inventory.

**Are Steam storefront results the same worldwide?**

Steam supports product pricing in 37 currencies and four region groups. Compare offers within the intended storefront rather than assuming one worldwide offer.

**How quickly can Steam's sales rankings change?**

Steam's live top-seller calculation uses spending from the trailing 24 hours, with extra weight on the last three hours. It can respond to recent demand rather than waiting for a completed calendar week.

**Does a top-seller rank measure copies sold?**

Steam ranks top sellers by revenue. Base-game purchases, DLC, and microtransactions all contribute, so the ranking does not establish unit sales.

