How to Use IronPlanet auction lots in Windsurf
Returns equipment listings belonging to one IronPlanet auction. Use it to review a selected sale's inventory before opening individual equipment previews.
Prompts to try with IronPlanet auction lots in Windsurf
Copy an example into Windsurf, or ask in your own words.
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 Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run IronPlanet auction lots
One request; the result comes back by polling or a webhook.
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: Windsurf finds IronPlanet auction lots on Spiral, shows the price and runs it.
IronPlanet auction lots providers and prices
Spiral runs IronPlanet auction lots through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Sort | bm asc, p asc, p desc, d asc, ad asc, ad desc, or yr desc | bm asc | Sort key as the site encodes it: |
| Page size | 20, 60, or 100 | 20 | Items per page ( |
| Sale group ID | a number from 1 | Sale group id from |
Every API field of IronPlanet · List auction lots is on its tool page: open its card above.
What can you do with IronPlanet auction lots in Windsurf?
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.
More on IronPlanet auction lots and Windsurf
Overview
IronPlanet auction lots in other agents
Questions about IronPlanet auction lots in Windsurf
Can Windsurf use IronPlanet auction lots?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run IronPlanet auction lots like any built-in tool.
How much does IronPlanet auction lots cost in Windsurf?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need an Alexandria account to use IronPlanet auction lots in Windsurf?
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 Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while IronPlanet auction lots runs?
IronPlanet auction lots runs in the background. Windsurf 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.
Start using IronPlanet auction lots in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


