[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [IronPlanet auction lots](https://spiral.ai/integrations/muse-code/ironplanet-auction-lots)

# How to Use IronPlanet auction lots in Muse Code

Returns equipment listings belonging to one IronPlanet auction. Use it to review a selected sale's inventory before opening individual equipment previews.

|  |  |
| --- | --- |
| Model | IronPlanet auction lots |
| 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 auction lots in Muse Code

- Use IronPlanet auction lots for https://www.ironplanet.com/jsp/s/auction.ips?msg=117227 and populate this project's auction inventory view with the returned equipment.
- Use IronPlanet auction lots to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from IronPlanet auction lots and tell me what changed since last week.
- Check IronPlanet auction lots and summarize what you find in three bullet points.
- Pull the newest data from IronPlanet auction lots and give me the result as a table.

## How to set up IronPlanet auction lots in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 auction lots**: 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_auction_lots",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds IronPlanet auction lots on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## IronPlanet auction lots tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | Alternatively a pasted auction URL: https://www.ironplanet.com/jsp/s/auction.ips?msg=117083 or /jsp/auction/auction_info.jsp?groupId=117083. |
| sort | bm asc, p asc, p desc, d asc, ad asc, ad desc, yr desc | bm asc | Sort key as the site encodes it: `bm asc` Best Match, `p asc`/`p desc` price, `d asc` closest to the exit IP (not reproducible), `ad asc`/`ad desc` ending sooner/later, `yr desc` year (newest first). |
| page_size | 20, 60, 100 | 20 | Items per page (`prows`). |
| continuation |  | — | Continuation cursor: the `next_offset` of the previous page as a decimal string. Pattern: ^[0-9]{1,7}$. |
| sale_group_id | 1 to … | — | Sale group id from `list_upcoming_auctions` (`sale_group_id`). |

## What can you do with IronPlanet auction lots in Muse Code?

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 Muse Code guides](https://spiral.ai/integrations/muse-code)

## IronPlanet auction lots in other agents

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

## More Muse Code guides

- [IKEA product search](https://spiral.ai/integrations/muse-code/ikea-product-search)
- [IronPlanet equipment listings](https://spiral.ai/integrations/muse-code/ironplanet-equipment-listings)
- [IKEA product safety and assembly documents](https://spiral.ai/integrations/muse-code/ikea-product-safety-and-assembly-documents)
- [IronPlanet equipment preview](https://spiral.ai/integrations/muse-code/ironplanet-equipment-preview)
- [IKEA product reviews](https://spiral.ai/integrations/muse-code/ikea-product-reviews)
- [IronPlanet equipment search suggestions](https://spiral.ai/integrations/muse-code/ironplanet-equipment-search-suggestions)

## Questions about IronPlanet auction lots in Muse Code

**Can Muse Code use IronPlanet auction lots?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run IronPlanet auction lots like any built-in tool.

**How much does IronPlanet auction lots cost in Muse Code?**

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

**Do I need an Alexandria account to use IronPlanet auction lots in Muse Code?**

No. Spiral runs IronPlanet auction lots 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 auction lots in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while IronPlanet auction lots runs?**

IronPlanet auction lots runs in the background. Muse Code 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.

