Car Deals

Aggregates Cars.com, Autotrader, and KBB listings with CARFAX-style filters for easy car shopping.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "siddarthakoppaka-car_deals_search_mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/car_deals_search_mcp/src/server.js"
      ]
    }
  }
}

You can search and compare used car listings from Cars.com, Autotrader, and KBB using AI-assisted queries. This MCP server aggregates listings, extracts key details like price and mileage, and applies CARFAX-style filters to help you find good deals faster.

How to use

Connect an MCP client to the car deals MCP server to perform multi-source searches. You provide the make and model you want, and you can apply optional filters such as one-owner vehicles, no accidents, and personal use. The server queries Cars.com, Autotrader, and KBB in parallel, normalizes results, and returns a consistent listing format with dealer info and source.

How to install

Prerequisites: you need Node.js version 16 or higher and a Chrome/Chromium browser for Puppeteer to run.

Install steps, in order:

# Install dependencies from the project root
npm install

Run the MCP server locally using the standard Node command shown in the usage examples.

# Start the MCP server (adjust the path to your local copy)
node /absolute/path/to/car_deals_search_mcp/src/server.js

Additional notes

Testing locally lets you run predefined tests and perform ad-hoc searches to verify behavior.

To exercise a sample search, you can run the scraper directly for quick validation.

# Run tests
npm test

# Or perform a targeted in-process search (example)
node -e "
const { scrapeCarscom } = require('./src/scraper.js');
scrapeCarscom({
  make: 'Toyota',
  model: 'Camry',
  oneOwner: true,
  noAccidents: true,
  personalUse: true
}, 5).then(listings => listings.forEach(l => console.log(l.format())));
"

Usage tips

When you configure an MCP client, point the client at the local server you started. The server supports a single stdio configuration using Node to run the server file.

Available tools

search_car_deals

Multi-source car listings search tool that queries Cars.com, Autotrader, and KBB in parallel, applying optional CARFAX-style filters and producing normalized results with deal ratings and dealer info.