[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [IronPlanet equipment preview](https://spiral.ai/integrations/opencode/ironplanet-equipment-preview)

# How to Use IronPlanet equipment preview in opencode

Returns a machine's public preview, including features, meter reading, serial number, and photo information when available. Use it to examine a shortlisted item beyond its listing summary.

|  |  |
| --- | --- |
| Model | IronPlanet equipment preview |
| 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 equipment preview in opencode

- Use IronPlanet equipment preview for item 14994469 and add its returned features, serial number, meter reading, and photo count to this project's equipment detail view.
- Use IronPlanet equipment preview to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from IronPlanet equipment preview and tell me what changed since last week.
- Check IronPlanet equipment preview and summarize what you find in three bullet points.
- Pull the newest data from IronPlanet equipment preview and give me the result as a table.

## How to set up IronPlanet equipment preview in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 equipment preview**: 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/get_equipment_preview",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: opencode finds IronPlanet equipment preview on Spiral, shows the price and runs it.

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

## IronPlanet equipment preview tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | Alternatively a pasted item URL: https://www.ironplanet.com/for-sale/{slug}/{equipId}, /jsp/s/item/{equipId} or /jsp/equip/bidPage.jsp?equipId=... |
| equip_id |  | — | Item id from a listing (`equip_id`), digits only. Pattern: ^[0-9]{1,12}$. |

## What can you do with IronPlanet equipment preview in opencode?

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.

### Compare documentation before reviewing a machine

Start with equipment listings or one auction's lots, then compare selected previews by available serial number, meter reading, features, and photo count. Use the comparison to decide which machines deserve closer review.

### 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 opencode guides](https://spiral.ai/integrations/opencode)

## IronPlanet equipment preview in other agents

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

## More opencode guides

- [IronPlanet equipment listings](https://spiral.ai/integrations/opencode/ironplanet-equipment-listings)
- [IronPlanet equipment search suggestions](https://spiral.ai/integrations/opencode/ironplanet-equipment-search-suggestions)
- [IronPlanet auction lots](https://spiral.ai/integrations/opencode/ironplanet-auction-lots)
- [IronPlanet upcoming auctions](https://spiral.ai/integrations/opencode/ironplanet-upcoming-auctions)
- [IKEA product search](https://spiral.ai/integrations/opencode/ikea-product-search)
- [JLCPCB component categories](https://spiral.ai/integrations/opencode/jlcpcb-component-categories)

## Questions about IronPlanet equipment preview in opencode

**Can opencode use IronPlanet equipment preview?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run IronPlanet equipment preview like any built-in tool.

**How much does IronPlanet equipment preview cost in opencode?**

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

**Do I need an Alexandria account to use IronPlanet equipment preview in opencode?**

No. Spiral runs IronPlanet equipment preview 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 equipment preview in opencode?**

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

**Does opencode wait while IronPlanet equipment preview runs?**

IronPlanet equipment preview runs in the background. opencode 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.

