[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [IronPlanet upcoming auctions](https://spiral.ai/integrations/gemini-cli/ironplanet-upcoming-auctions)

# How to Use IronPlanet upcoming auctions in Gemini CLI

Returns upcoming online auctions for the selected IronPlanet marketplace. Use it to identify scheduled sales before retrieving their lots.

|  |  |
| --- | --- |
| Model | IronPlanet upcoming auctions |
| 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 IronPlanet upcoming auctions in Gemini CLI

- Use IronPlanet upcoming auctions to retrieve scheduled IronPlanet sales and build an auction selection view in this project using the returned records.
- Use IronPlanet upcoming auctions to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from IronPlanet upcoming auctions and tell me what changed since last week.
- Check IronPlanet upcoming auctions and summarize what you find in three bullet points.
- Pull the newest data from IronPlanet upcoming auctions and give me the result as a table.

## How to set up IronPlanet upcoming auctions in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 IronPlanet upcoming auctions**: 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": "ironplanet-com/equipment-auctions/list_upcoming_auctions",
    "input": {
      "realm_id": 1
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds IronPlanet upcoming auctions on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## IronPlanet upcoming auctions tools and prices

- [IronPlanet · List upcoming auctions](https://spiral.ai/tools/alexandria/ironplanet-com/equipment-auctions/list_upcoming_auctions) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| realm_id | 1 to 999 | 1 | Site realm: 1 IronPlanet (default), 21 TruckPlanet, 22 GovPlanet, 3 Europe, 2 Australia, 23 GovPlanet EU, 71 SalvageSale. |

## What can you do with IronPlanet upcoming auctions in Gemini CLI?

Build an equipment buying shortlist that connects IronPlanet search terminology, available machines, scheduled sales, and public previews. With authorized access, a coding agent can organize the returned records into your project's procurement view.

### Prepare an excavator purchase shortlist

Resolve excavator terminology through search suggestions, compare equipment listings, identify upcoming sales, review their lots, and examine the features and meter readings of selected machines.

### Plan a farm equipment replacement

Find the site's tractor categories, compare listed John Deere equipment, identify relevant scheduled auctions, review available lots, and check public previews for features and serial numbers.

### Review truck fleet purchase candidates

Identify truck category terminology, browse Freightliner listings, choose upcoming sales, inspect their inventories, and compare selected vehicles using available meter readings and photo information.

### Find equipment for a warehouse expansion

Resolve forklift categories, browse Toyota equipment, review upcoming auction opportunities and their lots, then examine public previews for the features needed by the warehouse.

### Prepare a buyer's auction agenda

Identify upcoming sales, review their lots, and select the equipment worth discussing before each auction. Keep sale selection separate from the review of individual machines.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## IronPlanet upcoming auctions in other agents

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

## More Gemini CLI guides

- [IronPlanet equipment search suggestions](https://spiral.ai/integrations/gemini-cli/ironplanet-equipment-search-suggestions)
- [JLCPCB component categories](https://spiral.ai/integrations/gemini-cli/jlcpcb-component-categories)
- [IronPlanet equipment preview](https://spiral.ai/integrations/gemini-cli/ironplanet-equipment-preview)
- [JLCPCB component details](https://spiral.ai/integrations/gemini-cli/jlcpcb-component-details)
- [IronPlanet equipment listings](https://spiral.ai/integrations/gemini-cli/ironplanet-equipment-listings)
- [JLCPCB component search](https://spiral.ai/integrations/gemini-cli/jlcpcb-component-search)

## Questions about IronPlanet upcoming auctions in Gemini CLI

**Can Gemini CLI use IronPlanet upcoming auctions?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run IronPlanet upcoming auctions like any built-in tool.

**How much does IronPlanet upcoming auctions cost in Gemini CLI?**

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

**Do I need an Alexandria account to use IronPlanet upcoming auctions in Gemini CLI?**

No. Spiral runs IronPlanet upcoming auctions on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up IronPlanet upcoming auctions in Gemini CLI?**

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

**Does Gemini CLI wait while IronPlanet upcoming auctions runs?**

IronPlanet upcoming auctions runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Does IronPlanet only list equipment in scheduled auctions?**

No. IronPlanet also offers Marketplace-E, a 24/7 marketplace where equipment can be bought every day. An upcoming auction list therefore serves a narrower purpose than browsing equipment for sale.

**How often does IronPlanet hold auctions?**

IronPlanet describes its online and onsite auctions as weekly. That describes the sale schedule, not a guaranteed refresh interval for every listing or preview.

**How current is an IronPlanet condition report?**

The report describes visible condition on the inspection date. Retrieving equipment information later does not make that inspection a new assessment of the machine.

**Are the displayed hours or miles verified lifetime usage?**

No. IronPlanet explicitly does not guarantee actual equipment hours or miles. A displayed meter reading should not be described as verified lifetime usage.

**Do public IronPlanet pages permit unrestricted automated collection?**

No. IronPlanet's site terms prohibit robots, scrapers, data mining tools, and other automated collection methods. Public visibility alone does not establish permission for an automated workflow.

