[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Kelley Blue Book car listings](https://spiral.ai/integrations/opencode/kelley-blue-book-car-listings)

# How to Use Kelley Blue Book car listings in opencode

Returns matching KBB inventory with listing identifiers, VINs, asking prices, mileage, and deal ratings. Use it to find comparable vehicles near a US location before inspecting individual listings.

|  |  |
| --- | --- |
| Model | Kelley Blue Book car listings |
| 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 Kelley Blue Book car listings in opencode

- Use Kelley Blue Book car listings to find 2021–2023 Toyota Camrys near 90210 within 50 miles, then review how this project's comparison code handles VINs and mileage.
- Use Kelley Blue Book car listings to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Kelley Blue Book car listings and tell me what changed since last week.
- Check Kelley Blue Book car listings and summarize what you find in three bullet points.
- Pull the newest data from Kelley Blue Book car listings and give me the result as a table.

## How to set up Kelley Blue Book car listings in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Kelley Blue Book car listings**: 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": "kbb-com/vehicles/listings",
    "input": {
      "zip": "<zip>",
      "make": "<make>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Kelley Blue Book car listings on Spiral, shows the price and runs it.

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

## Kelley Blue Book car listings tools and prices

- [Kelley Blue Book · Listings](https://spiral.ai/tools/alexandria/kbb-com/vehicles/listings) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 40 | 1 | Result page; 25 listings per page. |
| sort | relevance, price_asc, price_desc, mileage_asc, year_desc, distance_asc, newest | relevance | Result order: relevance (KBB default), price_asc / price_desc by KBB derived price (advertised price plus fees, so advertised prices are only approximately ordered), mileage_asc, year_desc (newest model year first), distance_asc (nearest seller first), newest (most recently listed first). |
| trim |  | — | Trim name as shown in listings (e.g. SE, XLE, Sport Touring). Requires model. |
| model |  | — | kbb.com model slug, e.g. camry, civic, f150, model-3. Powertrain variants are not separate models (Kona Electric is kona, Bolt EV is bolt); an unknown slug fails with not_found naming the make's valid slugs. Omit for all models of the make. |
| year_max | 1981 to 2030 | — | Newest model year to include, inclusive; must not be below year_min. |
| year_min | 1981 to 2030 | — | Oldest model year to include, inclusive. |

## What can you do with Kelley Blue Book car listings in opencode?

Build a vehicle comparison that connects KBB inventory, listing details, trim specifications, and valuation estimates. A coding agent can use your project's comparison logic to keep seller asking prices separate from KBB benchmarks, within your data-use permissions.

### Prepare a used-car purchase shortlist

Find Toyota Camrys near Los Angeles, compare their trims, inspect the leading listings, and estimate values using each candidate's mileage and condition. Turn the findings into specific questions for the dealer.

### Compare trim premiums

Compare Honda Civic trims, matching local inventory, and individual listing details. Use vehicle-specific estimates to separate the trim premium from differences in mileage and condition.

### Compare two nearby shopping markets

Compare the same Subaru Outback model year and trim around Denver and Colorado Springs. Check local inventory, listing details, and regional valuations before deciding where to shop.

### Assess a lower-mileage premium

Find Mazda CX-5 candidates of the same year and trim with different odometer readings. Inspect their listing details and compare mileage-specific values to judge whether the lower-mileage option deserves its premium.

### Investigate a promising dealer listing

Find Honda CR-V candidates, then examine price history, warranty information, and Fair Purchase Price for the strongest matches. Prepare questions about the details that affect the purchase decision.

## Overview

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

## Kelley Blue Book car listings in other agents

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

## More opencode guides

- [Kelley Blue Book car listing details](https://spiral.ai/integrations/opencode/kelley-blue-book-car-listing-details)
- [Kelley Blue Book vehicle trims](https://spiral.ai/integrations/opencode/kelley-blue-book-vehicle-trims)
- [JLCPCB component suggestions](https://spiral.ai/integrations/opencode/jlcpcb-component-suggestions)
- [Kelley Blue Book vehicle value](https://spiral.ai/integrations/opencode/kelley-blue-book-vehicle-value)
- [JLCPCB component search](https://spiral.ai/integrations/opencode/jlcpcb-component-search)
- [Kickstarter categories and tags](https://spiral.ai/integrations/opencode/kickstarter-categories-and-tags)

## Questions about Kelley Blue Book car listings in opencode

**Can opencode use Kelley Blue Book car listings?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Kelley Blue Book car listings like any built-in tool.

**How much does Kelley Blue Book car listings cost in opencode?**

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

**Do I need an Alexandria account to use Kelley Blue Book car listings in opencode?**

No. Spiral runs Kelley Blue Book 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 Kelley Blue Book car listings in opencode?**

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

**Does opencode wait while Kelley Blue Book car listings runs?**

Kelley Blue Book car listings runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does KBB.com cover vehicles outside the United States?**

KBB.com pricing is specific to the United States. Its valuations account for local markets across 134 US geographic regions.

**How often does KBB refresh its values?**

KBB updates its pricing at least weekly. That schedule describes its valuation data, rather than a promise that each seller's listing is refreshed weekly.

**How far back does KBB's used-vehicle valuation coverage go?**

KBB provides used-vehicle values for vehicles up to 21 years old. This is a vehicle-age boundary, not 21 years of historical quotes for every car.

**Does KBB verify the information in seller listings?**

KBB says it cannot verify vehicle information supplied by sellers. A listing's stated equipment or condition therefore does not establish that KBB inspected the vehicle.

**Can I store or commercially republish KBB data?**

KBB's general website terms require written permission for storing or migrating its information and an advance agreement for commercial use. Public visibility does not establish permission to build a commercial dataset.

