[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [AuctionTime equipment search](https://spiral.ai/integrations/cursor/auctiontime-equipment-search)

# How to Use AuctionTime equipment search in Cursor

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 Cursor

- 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 Cursor

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor 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: Cursor finds AuctionTime equipment search on Spiral, shows the price and runs it.

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

## 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 Cursor?

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

## 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)
- [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)
- [VS Code](https://spiral.ai/integrations/vscode/auctiontime-equipment-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/auctiontime-equipment-search)
- [Zapier](https://spiral.ai/integrations/zapier/auctiontime-equipment-search)

## More Cursor guides

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

## Questions about AuctionTime equipment search in Cursor

**Can Cursor use AuctionTime equipment search?**

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

**How much does AuctionTime equipment search cost in Cursor?**

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

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

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 Cursor?**

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

**Does Cursor wait while AuctionTime equipment search runs?**

AuctionTime equipment search runs in the background. Cursor 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.

