Skip to main content
Glama

@jtgregoire93/mcp-car-shopping

MCP server connector for CarMax and Carvana. Automates their flows with Playwright, driving your local Google Chrome or a Browserbase remote browser.

For CarGurus, use CarGurus' official connector instead (claude.ai → Settings → Connectors → CarGurus). See CarGurus' setup guide.

Tools

Tool

Description

search_all

Search CarMax and Carvana at once with the same filters

carmax_search_inventory

Search CarMax inventory by make, model, year, price, and ZIP code

carmax_get_vehicle_details

Get full details (price, VIN, specs, history highlights, store, photos) for a CarMax vehicle

carmax_schedule_test_drive

Schedule a test drive appointment at CarMax

carmax_get_instant_offer

Get an instant offer for selling your car by VIN or license plate

carvana_search_inventory

Search Carvana inventory by make, model, year, price, and ZIP code

carvana_get_vehicle_details

Get full details (price, total with tax/title, VIN, specs) for a Carvana vehicle

carvana_get_offer

Get a Carvana sell/trade-in offer by VIN or license plate

Related MCP server: Zipcar MCP Server

Requirements

  • Node.js ≥ 18

  • Google Chrome installed, or a Browserbase account

Setup

By default the server drives your installed Google Chrome. It opens a real Chrome window parked off-screen, because both sites block headless Chrome. It keeps its own profile at ~/.cache/mcp-car-shopping/chrome-profile so the sites' bot-check cookies carry over between runs.

Environment Variables

Variable

Effect

BROWSERBASE_CDP_URL

Use a Browserbase remote browser instead of local Chrome, e.g. wss://connect.browserbase.com?apiKey=YOUR_KEY. Enable stealth mode / proxies; both sites block plain datacenter browsers.

CHROME_PROFILE_DIR

Use a different Chrome profile directory (default ~/.cache/mcp-car-shopping/chrome-profile). Give each concurrent server its own.

HEADLESS=1

Run local Chrome headless. Usually gets blocked by CarMax and Carvana.

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "car-shopping": {
      "command": "npx",
      "args": ["-y", "@jtgregoire93/mcp-car-shopping"]
    }
  }
}

Add "env": { "BROWSERBASE_CDP_URL": "..." } to use Browserbase instead of local Chrome.

Claude Code:

claude mcp add car-shopping -- npx -y @jtgregoire93/mcp-car-shopping

Tool Details

search_all

Runs the CarMax and Carvana searches in parallel. A site that fails is reported without failing the other.

search_all({ zip: "90210", make: "Toyota", model: "Camry", year_min: 2019, price_max: 30000, limit: 5 })

Search (per site)

Both take the same filters: zip, make, model, year_min, year_max, mileage_max, price_min, price_max, limit. Make and model are applied by the site; the year, price and mileage filters are applied to the first page of results (about 48 cars on CarMax), so a narrow filter can return fewer than limit. CarMax sorts by distance from zip. Carvana ships nationwide and ignores zip.

carmax_search_inventory({ zip: "90210", make: "Toyota", model: "Camry", year_min: 2019, year_max: 2023, price_max: 30000, limit: 10 })
carvana_search_inventory({ make: "Honda", model: "Civic", price_max: 25000 })

Vehicle details

Use the ID from the search results:

carmax_get_vehicle_details({ stock_number: "25123456" })
carvana_get_vehicle_details({ vehicle_id: "3012345" })

Returns title, price, mileage, VIN and specs, plus site-specific info: store location, vehicle history highlights and photo URLs for CarMax; total price with estimated tax, title and registration for Carvana.

carmax_schedule_test_drive

Books a real appointment, so it only runs with confirm: true. Without it, it returns a preview.

carmax_schedule_test_drive({
  stock_number: "25123456",
  first_name: "Jane",
  last_name: "Smith",
  email: "jane@example.com",
  phone: "5551234567",
  preferred_date: "Saturday",
  preferred_time: "afternoon",
  confirm: true
})

carmax_get_instant_offer / carvana_get_offer

// By VIN
carmax_get_instant_offer({ vin: "1HGCM82633A123456", mileage: 85000, zip: "90210" })

// By license plate
carvana_get_offer({ license_plate: "ABC1234", state: "CA", mileage: 85000 })

Both sites identify the car from the VIN or plate, then ask style and condition questions (and an email) before showing an offer. The tool enters the VIN/plate and ZIP, waits for the lookup, and returns what the site found plus the questions it stopped at, with a link to finish on the site.

Development

npm install
npm run typecheck
npm run build   # bundles src/index.ts to dist/index.js

# call tools from the command line
node scripts/call.mjs --list
node scripts/call.mjs carmax_search_inventory '{"make":"Audi","model":"A4","zip":"23452"}'

How It Works

This connector uses Playwright with your local Chrome or a Browserbase remote browser session (via CDP) to automate each site. CarMax search reads the full car records CarMax embeds in its search page; everything else reads the rendered pages. No unofficial APIs — all data comes directly from CarMax.com and Carvana.com.

License

MIT

Available Tools

8 tools
carmax_get_instant_offerA

Get an instant cash offer from CarMax for selling your car. Provide VIN or license plate + state. Returns estimated offer range and next steps.

Inputs: vin, zip, state, mileage, +1 more.

carmax_get_vehicle_detailsA

Get full details for a specific CarMax vehicle by stock number, including specs, photos, vehicle history highlights, and store location.

Inputs: stock_number (required).

carmax_schedule_test_driveA

Schedule a test drive appointment at CarMax for a specific vehicle. This books a real appointment. Requires confirm:true to actually book; otherwise returns a preview only.

Inputs: email (required), phone (required), last_name (required), first_name (required), +4 more.

carmax_search_inventoryA

Search CarMax inventory for used vehicles. Filter by make, model, year range, price range, and location (ZIP code). Returns a list of matching vehicles with stock numbers, prices, mileage, and links.

Inputs: zip, make, limit, model, +5 more.

carvana_get_offerA

Get a cash offer from Carvana for selling or trading in your car. Provide VIN or license plate + state. Returns the offer if Carvana shows one, otherwise next steps.

Inputs: vin, zip, state, mileage, +1 more.

carvana_get_vehicle_detailsA

Get full details for a specific Carvana vehicle by vehicle ID, including price, mileage, VIN, specs, features, and photos.

Inputs: vehicle_id (required).

carvana_search_inventoryA

Search Carvana inventory for used vehicles. Filter by make, model, year range, price range, and ZIP code. Returns vehicle IDs, prices, mileage, and links.

Inputs: zip, make, limit, model, +5 more.

search_allA

Search CarMax and Carvana at once with the same filters. Returns each site's results side by side, sorted by price. A site that fails is reported without failing the other.

Inputs: zip, make, limit, model, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: site-specific inventory search, vehicle details, cash offers, test-drive scheduling, and a cross-site aggregate search. The site prefixes make near-equivalent CarMax/Carvana operations unambiguous, and search_all is explicitly differentiated as a side-by-side aggregator.

    Naming Consistency4/5

    Most tools follow a consistent snake_case site-prefixed verb_noun pattern, such as carmax_search_inventory and carvana_get_vehicle_details. The only notable deviation is search_all, which lacks the site prefix but is still readable and intentional as a cross-site tool.

    Tool Count5/5

    Eight tools is well-scoped for a car-shopping server covering two marketplaces. The set includes search, details, offers, test-drive scheduling, and an aggregate search without excessive redundancy.

    Completeness4/5

    Core car-shopping workflows are covered: inventory search, vehicle details, cash/trade-in offers, and test-drive scheduling. Minor gaps remain, such as no Carvana test-drive scheduling and no broader financing or saved-search operations, but these are workable omissions.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables users to automate Zipcar car sharing tasks such as searching for available vehicles, managing reservations, and ending trips using stealth browser automation. It provides a standardized interface for interacting with Zipcar's services through natural language and the Model Context Protocol.
      6
      11 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 25 interactive automotive intelligence tools for real-time market data, including VIN decoding, price predictions, and inventory analytics. It enables AI assistants to perform car searches, trade-in estimations, and market trend analysis using the Model Context Protocol.
      2
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to search and retrieve used and new car listings from carsales.com.au, with support for various filters and detailed listing information including images. It uses a real browser to bypass bot protection and integrates with MCP-compatible clients like Claude Desktop and Claude Code.
      19
      2
      MIT