CarMax Server

MCP server connector for CarMax — the used car marketplace. Automates CarMax flows via Playwright + Browserbase.

Tools

Requirements

• Node.js ≥ 18
• Browserbase account with a CDP URL

Setup

Environment Variables

export BROWSERBASE_CDP_URL="wss://connect.browserbase.com?apiKey=YOUR_KEY"

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "carmax": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-carmax"],
      "env": {
        "BROWSERBASE_CDP_URL": "wss://connect.browserbase.com?apiKey=YOUR_KEY"
      }
    }
  }
}

Tool Details

search_inventory

Search for vehicles by various filters:

search_inventory({
  zip: "90210",
  make: "Toyota",
  model: "Camry",
  year_min: 2019,
  year_max: 2023,
  price_max: 30000,
  limit: 10
})

get_vehicle_details

Get detailed info for a specific vehicle (stock number from search results):

get_vehicle_details({ stock_number: "25123456" })

Returns: title, price, mileage, VIN, location, specs, features, photo URLs, Carfax info.

schedule_test_drive

Schedule a test drive appointment:

schedule_test_drive({
  stock_number: "25123456",
  first_name: "Jane",
  last_name: "Smith",
  email: "[email protected]",
  phone: "5551234567",
  preferred_date: "Saturday",
  preferred_time: "afternoon"
})

get_instant_offer

Get a cash offer for your car:

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

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

How It Works

This connector uses Playwright over a Browserbase remote browser session (via CDP) to automate CarMax's website. No unofficial APIs — all data comes directly from CarMax.com.

License

MIT — Strider Labs