[Integrations](https://spiral.ai/integrations) › [VS Code](https://spiral.ai/integrations/vscode) › [AuctionTime equipment search](https://spiral.ai/integrations/vscode/auctiontime-equipment-search)

# How to Use AuctionTime equipment search in VS Code

Returns matching upcoming or closed equipment lots, including descriptions, auction dates, and seller locations. Use it to find candidates across sales before reading individual lot details.

|  |  |
| --- | --- |
| Model | AuctionTime equipment search |
| Available through | Alexandria |
| Category | Listings |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with AuctionTime equipment search in VS Code

- Use AuctionTime equipment search to find upcoming Caterpillar 320 lots in Texas and create a shortlist in my project with descriptions, auction dates, and seller locations.
- Use AuctionTime equipment search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from AuctionTime equipment search and tell me what changed since last week.
- Check AuctionTime equipment search and summarize what you find in three bullet points.
- Pull the newest data from AuctionTime equipment search and give me the result as a table.

## How to set up AuctionTime equipment search in VS Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to VS Code on the console's Agents & MCP page, or run:

```bash
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
```

2. **Sign in**: VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

### Use the Spiral skill

1. **Send VS 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 AuctionTime equipment search**: 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": "auctiontime-com/equipment-auctions/search_auction_lots",
    "input": {
      "page": 1
    }
  }'
```

Then paste one of the prompts above: VS Code finds AuctionTime equipment search on Spiral, shows the price and runs it.

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

## AuctionTime equipment search tools and prices

- [AuctionTime · Search auction lots](https://spiral.ai/tools/alexandria/auctiontime-com/equipment-auctions/search_auction_lots) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to … | 1 | 1-based page; 28 lots per page. |
| sort | best_match, time_remaining, price_asc, price_desc, year_asc, year_desc, hours_asc, hours_desc, manufacturer, model, serial_number, stock_number, recently_added, recently_updated | best_match | sort |
| model |  | — | Model facet value, e.g. `320`. |
| state |  | — | Full US state or Canadian province name as the site spells it, e.g. `Texas`. Two-letter codes return no results. |
| keywords |  | — | Free-text keywords (title, manufacturer, model, serial ...). |
| category_id | 1 to … | — | Numeric category id from `list_categories` or a category URL (e.g. 16044). |

## What can you do with AuctionTime equipment search in VS Code?

Build an equipment buying worksheet that organizes AuctionTime categories, sale dates, catalogs, and candidate lots. In your project's files, keep seller-provided specifications separate from inspection findings and account for restricted data use.

### Plan an excavator purchase

Find the relevant excavator categories, check upcoming sale dates, review sale catalogs, and search for Caterpillar 320 machines. Read shortlisted lots for specifications, photos, and seller-provided condition notes.

### Prepare a tractor replacement shortlist

Identify tractor categories, review the auction calendar and sale inventories, then find John Deere 6155R candidates. Compare each candidate's reported specifications and available photos before arranging an inspection.

### Review trucks for a fleet purchase

Locate truck categories and upcoming sales, examine their catalogs, and search for Ford F-550 lots. Use individual records to review available specifications, serial numbers, photos, and seller descriptions.

### Find attachments at upcoming sales

Start with attachment categories, identify upcoming sales, and examine catalogs for excavator buckets or skid steer attachments. Search across listings and read candidate lot specifications to prepare compatibility questions for the seller.

### Compare specifications with closed listings

Find closed lots for the same machine model and inspect their descriptions and specifications. Use them to compare equipment configurations, without treating unavailable winning bids as evidence of market value.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All VS Code guides](https://spiral.ai/integrations/vscode)

## AuctionTime equipment search in other agents

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

## More VS Code guides

- [AuctionTime equipment categories](https://spiral.ai/integrations/vscode/auctiontime-equipment-categories)
- [AuctionTime lot details](https://spiral.ai/integrations/vscode/auctiontime-lot-details)
- [AuctionTime auction calendar](https://spiral.ai/integrations/vscode/auctiontime-auction-calendar)
- [AuctionTime sale catalog](https://spiral.ai/integrations/vscode/auctiontime-sale-catalog)
- [Auction.com property valuation](https://spiral.ai/integrations/vscode/auction-com-property-valuation)
- [Baton Rouge condemnation cases](https://spiral.ai/integrations/vscode/baton-rouge-condemnation-cases)

## Questions about AuctionTime equipment search in VS Code

**Can VS Code use AuctionTime equipment search?**

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run AuctionTime equipment search like any built-in tool.

**How much does AuctionTime equipment search cost in VS 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 VS Code plan is separate.

**Do I need an Alexandria account to use AuctionTime equipment search in VS Code?**

No. Spiral runs AuctionTime equipment search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up AuctionTime equipment search in VS Code?**

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

**Does VS Code wait while AuctionTime equipment search runs?**

AuctionTime equipment search runs in the background. VS Code starts the run, checks on it and gives you the json when it's ready.

**What equipment does AuctionTime cover?**

AuctionTime covers construction, agriculture, and trucking equipment. Its listings include new and used machines, trucks, trailers, and attachments.

**How often does AuctionTime add listings?**

AuctionTime says new listings are added every day. That does not establish how often an API response refreshes.

**Can an advertised auction closing time change?**

Yes. AuctionTime says last-minute bids can extend closing by up to 40 seconds, or 20 seconds for Quick Bids, with further extensions while bidding continues.

**Does AuctionTime verify equipment condition?**

AuctionTime says it does not inspect or confirm equipment condition. Listing descriptions come from auctioneers and dealers, so specifications and condition claims are seller-provided information.

**Do closed auction records include winning bid amounts?**

The documented closed-lot search excludes final bid amounts. It can provide equipment descriptions, auction dates, and seller locations, but it cannot support a sold-value comparison by itself.

