mcp-car-shopping
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HEADLESS | No | Run local Chrome headless. Usually gets blocked by CarMax and Carvana. | 0 |
| CHROME_PROFILE_DIR | No | Use a different Chrome profile directory. Give each concurrent server its own. | ~/.cache/mcp-car-shopping/chrome-profile |
| BROWSERBASE_CDP_URL | No | 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. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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. |
| 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. |
| carmax_get_vehicle_detailsA | Get full details for a specific CarMax vehicle by stock number, including specs, photos, vehicle history highlights, and store location. |
| 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. |
| 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. |
| 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. |
| carvana_get_vehicle_detailsA | Get full details for a specific Carvana vehicle by vehicle ID, including price, mileage, VIN, specs, features, and photos. |
| 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
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.
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.
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.
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.