How to Use CarGurus used car listings in Cursor
Returns matching US used-car listings near a ZIP code, with vehicle and market-comparison information. Use it to build a local shortlist before examining each car’s full record.
Prompts to try with CarGurus used car listings in Cursor
Copy an example into Cursor, or ask in your own words.
Use CarGurus used car listings to find Toyota Camry inventory near ZIP 02139 and map the returned mileage, dealer location, and deal rating into our comparison view.
Use CarGurus used car listings to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from CarGurus used car listings and tell me what changed since last week.
Check CarGurus used car listings and summarize what you find in three bullet points.
Pull the newest data from CarGurus used car listings and give me the result as a table.
How to set up CarGurus used car listings in Cursor
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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):
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - 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
- Send Cursor 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 CarGurus used car listings
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": "cargurus-com/vehicles/search_listings", "input": { "zip": "<zip>" } }'
Then paste one of the prompts above: Cursor finds CarGurus used car listings on Spiral, shows the price and runs it.
CarGurus used car listings providers and prices
Spiral runs CarGurus used car listings through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Cursor for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 10000 | 1-based page number (page 1 carries 18 organic results, later pages 21, plus sponsored tiles); use next_page from the previous result. A page past the last one is invalid_input. | |
| End year | 1900 to 2100 | Latest model year. | |
| Sort dir | ASC or DESC | Sort direction. Default ASC. | |
| Max price | a number from 0 | Maximum listing price in USD. | |
| Min price | a number from 0 | Minimum listing price in USD. | |
| Sort type | BEST_MATCH, DEAL_SCORE, PRICE, MILEAGE, PROXIMITY, NEWEST_CAR_YEAR, or AGE_IN_DAYS | Sort key: BEST_MATCH (default), DEAL_SCORE (best deals first), PRICE, MILEAGE, PROXIMITY, NEWEST_CAR_YEAR, AGE_IN_DAYS (listing age). | |
| Start year | 1900 to 2100 | Earliest model year. | |
| Max mileage | a number from 0 | Maximum odometer miles. | |
| Max results | 1 to 24 | Return only the first N listings of the page (the site's page is 24 tiles; next_page still advances by site page). Default: the whole page. | |
| Min mileage | a number from 0 | Minimum odometer miles. | |
| Distance miles | 1 to 50000 | Search radius in miles; the site offers 10, 25, 50, 75, 100, 150, 200, 500 and 50000 (nationwide). Default 50. Only listings physically within the radius are returned (the site's nationwide store-transfer / home-delivery padding is switched off). |
Every API field of CarGurus · Search listings is on its tool page: open its card above.
What can you do with CarGurus used car listings in Cursor?
Build a vehicle comparison feature that connects CarGurus catalog names with local inventory and ownership research. Use the returned records to keep model-level reviews separate from individual listing details.
Build a first-car shortlist
Browse makes and models, resolve Toyota Corolla and Honda Civic names, compare local listings, read owner experiences, and inspect the details of the strongest candidates.
Research cars before relocating
Explore brands and model choices for a move to Denver, resolve the selected vehicle names, find nearby inventory, and combine model reviews with individual vehicle histories.
Compare used electric-car candidates
Start with available makes and models, identify Nissan Leaf and Chevrolet Bolt matches, compare listings near Seattle, and read owner feedback before examining specific cars.
Choose an SUV to test-drive
Browse brand and model choices, resolve Subaru Forester and Toyota RAV4 names, compare nearby listings and owner reviews, then inspect each candidate’s specifications and history.
Prepare questions for a dealer visit
Compare a shortlisted car with nearby listings, examine its price analysis and vehicle history, and use model owner reviews to identify questions worth asking during the visit.
Follow a personal vehicle shortlist
Revisit selected model names and local listings, then compare the details of shortlisted cars across checks. Keep model-level owner feedback separate from the history of each individual car.
CarGurus used car listings success rate and speed on Spiral
Success and speed over the last 24 hours, across every run of these tools on Spiral.
| Tool | Success | Median time | Runs |
|---|---|---|---|
| CarGurus · Search listings | 100.0% | 3.0s | 23 |
More on CarGurus used car listings and Cursor
Overview
CarGurus used car listings in other agents
Questions about CarGurus used car listings in Cursor
Can Cursor use CarGurus used car listings?
Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run CarGurus used car listings like any built-in tool.
How much does CarGurus used car listings 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 CarGurus used car listings in Cursor?
No. Spiral runs CarGurus used car listings on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up CarGurus used car listings in Cursor?
About two minutes: add the hosted server, then sign in.
Does Cursor wait while CarGurus used car listings runs?
CarGurus used car listings runs in the background. Cursor starts the run, checks on it and gives you the json when it's ready.
Does this cover every car for sale?
The documented search covers US used-car listings. CarGurus gathers inventory from participating franchise and independent dealers, so it should not be described as a complete census of cars for sale.
Are private-party advertisements included?
CarGurus says it does not currently host advertisements where individuals sell cars directly to other individuals. Its marketplace inventory comes from participating dealers.
How fresh is CarGurus’ market-value estimate?
CarGurus updates Instant Market Value daily. That schedule applies to its valuation calculations and does not establish a refresh schedule for every listing, catalog entry, or owner review.
Does CarGurus provide a guaranteed vehicle appraisal?
No. CarGurus explicitly describes Instant Market Value as pricing guidance rather than an official appraisal or guarantee.
Why might a car have no deal rating?
Missing dealer fee information is one documented reason. CarGurus gives those used listings a “No Rating” price analysis and moves them lower in search results.
Start using CarGurus used car listings in Cursor
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Cursor:
set up https://spiral.ai/SKILL.md


