Car Deals Search MCP

Search used car listings from Cars.com, Autotrader, and KBB with AI assistants

An MCP (Model Context Protocol) server that aggregates and searches car listings from multiple sources. Scrapes listings in parallel, extracts price, mileage, dealer info, and applies optional CARFAX-style filters (1-owner, no accidents, personal use).

🚀 Quick Start

Prerequisites

Node.js (v16 or higher)
Chrome/Chromium browser installed (required by Puppeteer)
- If Chrome is not in the default location, set PUPPETEER_EXECUTABLE_PATH environment variable to point to your Chrome/Chromium binary

Installation

# Clone the repository
git clone https://github.com/SiddarthaKoppaka/car_deals_search_mcp.git
cd car_deals_search_mcp

# Install dependencies (includes Puppeteer)
npm install

Using with MCP Clients

Configure your MCP client (Claude Desktop, VS Code, GitHub Copilot, etc.) to use this server:

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

For other MCP clients, refer to their documentation and use:

Command: node
Args: ["<absolute-path-to-repo>/src/server.js"]

Testing Standalone

# Run the test command
npm test

# Or test manually with a specific search
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())));
"

✨ Features

Multi-source aggregation: Search Cars.com, Autotrader, and KBB simultaneously
Smart filtering: CARFAX-style filters (1-Owner, No Accidents, Personal Use)
Deal ratings: Heuristic-based deal quality assessment
Parallel scraping: Fast concurrent queries across sources
Stealth mode: Puppeteer with anti-bot detection techniques

📊 Supported Sources

Source	Price	Mileage	Deal Rating	Dealer Info	CARFAX Filters
Cars.com	✅	✅	✅	✅	✅
Autotrader	✅	✅	⚠️ Limited	✅	⚠️ Limited
KBB	✅	✅	✅	⚠️ Limited	⚠️ Limited

🔧 MCP Tool: `search_car_deals`

Parameters

Parameter	Type	Required	Description
`make`	string	✅	Car manufacturer (e.g., "Toyota", "Honda")
`model`	string	✅	Car model (e.g., "Camry", "Accord")
`zip`	string	❌	ZIP code for local search (default: "90210")
`yearMin`	integer	❌	Minimum model year
`yearMax`	integer	❌	Maximum model year
`priceMax`	integer	❌	Maximum price in USD
`mileageMax`	integer	❌	Maximum mileage
`maxResults`	integer	❌	Max results per source (default: 10)
`sources`	array	❌	Sources to query: `["cars.com","autotrader","kbb"]` (default: all)
`oneOwner`	boolean	❌	Filter for CARFAX 1-owner vehicles only
`noAccidents`	boolean	❌	Filter for no accidents reported
`personalUse`	boolean	❌	Filter for personal use only (not rental/fleet)

Example Response

🚗 2021 Toyota Camry XSE
   💰 Price: $23,491
   📏 Mileage: 52,649 mi
   ⭐ Deal Rating: Good Deal
   🏆 CARFAX: 1-Owner | No Accidents | Personal Use
   🏪 Dealer: Valencia BMW
   🌐 Source: Cars.com
   🔗 https://www.cars.com/vehicledetail/...

🛠️ Technical Details

Scraping: Puppeteer (headless Chromium) with stealth plugin to bypass bot detection
Concurrency: Parallel scraper workers for simultaneous multi-source queries
Protocol: Implements MCP (Model Context Protocol) for AI assistant integration
Data extraction: Source-specific parsers normalize listings into a common schema

Chrome/Chromium Requirement

This project uses Puppeteer, which requires Chrome or Chromium to be installed:

macOS: Chrome is typically at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
Linux: Usually auto-detected by Puppeteer or at /usr/bin/chromium-browser
Windows: Typically at C:\Program Files\Google\Chrome\Application\chrome.exe

If Puppeteer cannot find your browser, set the environment variable:

export PUPPETEER_EXECUTABLE_PATH="/path/to/chrome"

🧪 Development & Testing

# Run tests
npm test

# Test individual scrapers
node src/scraper.js

# View code structure
ls -la src/

🤝 Contributing

Contributions are welcome! Please follow this workflow:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Add tests for new functionality
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Please include test coverage for scraping/parsing changes to avoid regressions when source sites update.

📄 License

MIT License - see LICENSE file for details

🔗 Links

Repository: https://github.com/SiddarthaKoppaka/car_deals_search_mcp
Issues: https://github.com/SiddarthaKoppaka/car_deals_search_mcp/issues
MCP Protocol: https://modelcontextprotocol.io

Car Deals Search MCP

Search used car listings from Cars.com, Autotrader, and KBB with AI assistants

🚀 Quick Start

Prerequisites

Node.js (v16 or higher)
Chrome/Chromium browser installed (required by Puppeteer)
- If Chrome is not in the default location, set PUPPETEER_EXECUTABLE_PATH environment variable to point to your Chrome/Chromium binary

Installation

# Clone the repository
git clone https://github.com/SiddarthaKoppaka/car_deals_search_mcp.git
cd car_deals_search_mcp

# Install dependencies (includes Puppeteer)
npm install

Using with MCP Clients

Configure your MCP client (Claude Desktop, VS Code, GitHub Copilot, etc.) to use this server:

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

For other MCP clients, refer to their documentation and use:

Command: node
Args: ["<absolute-path-to-repo>/src/server.js"]

Testing Standalone

# Run the test command
npm test

# Or test manually with a specific search
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())));
"

✨ Features

Multi-source aggregation: Search Cars.com, Autotrader, and KBB simultaneously
Smart filtering: CARFAX-style filters (1-Owner, No Accidents, Personal Use)
Deal ratings: Heuristic-based deal quality assessment
Parallel scraping: Fast concurrent queries across sources
Stealth mode: Puppeteer with anti-bot detection techniques

📊 Supported Sources

Source	Price	Mileage	Deal Rating	Dealer Info	CARFAX Filters
Cars.com	✅	✅	✅	✅	✅
Autotrader	✅	✅	⚠️ Limited	✅	⚠️ Limited
KBB	✅	✅	✅	⚠️ Limited	⚠️ Limited

🔧 MCP Tool: `search_car_deals`

Parameters

Parameter	Type	Required	Description
`make`	string	✅	Car manufacturer (e.g., "Toyota", "Honda")
`model`	string	✅	Car model (e.g., "Camry", "Accord")
`zip`	string	❌	ZIP code for local search (default: "90210")
`yearMin`	integer	❌	Minimum model year
`yearMax`	integer	❌	Maximum model year
`priceMax`	integer	❌	Maximum price in USD
`mileageMax`	integer	❌	Maximum mileage
`maxResults`	integer	❌	Max results per source (default: 10)
`sources`	array	❌	Sources to query: `["cars.com","autotrader","kbb"]` (default: all)
`oneOwner`	boolean	❌	Filter for CARFAX 1-owner vehicles only
`noAccidents`	boolean	❌	Filter for no accidents reported
`personalUse`	boolean	❌	Filter for personal use only (not rental/fleet)

Example Response

🚗 2021 Toyota Camry XSE
   💰 Price: $23,491
   📏 Mileage: 52,649 mi
   ⭐ Deal Rating: Good Deal
   🏆 CARFAX: 1-Owner | No Accidents | Personal Use
   🏪 Dealer: Valencia BMW
   🌐 Source: Cars.com
   🔗 https://www.cars.com/vehicledetail/...

🛠️ Technical Details

Scraping: Puppeteer (headless Chromium) with stealth plugin to bypass bot detection
Concurrency: Parallel scraper workers for simultaneous multi-source queries
Protocol: Implements MCP (Model Context Protocol) for AI assistant integration
Data extraction: Source-specific parsers normalize listings into a common schema

Chrome/Chromium Requirement

This project uses Puppeteer, which requires Chrome or Chromium to be installed:

macOS: Chrome is typically at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
Linux: Usually auto-detected by Puppeteer or at /usr/bin/chromium-browser
Windows: Typically at C:\Program Files\Google\Chrome\Application\chrome.exe

If Puppeteer cannot find your browser, set the environment variable:

export PUPPETEER_EXECUTABLE_PATH="/path/to/chrome"

🧪 Development & Testing

# Run tests
npm test

# Test individual scrapers
node src/scraper.js

# View code structure
ls -la src/

🤝 Contributing

Contributions are welcome! Please follow this workflow:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Add tests for new functionality
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Please include test coverage for scraping/parsing changes to avoid regressions when source sites update.

📄 License

MIT License - see LICENSE file for details

🔗 Links

Repository: https://github.com/SiddarthaKoppaka/car_deals_search_mcp
Issues: https://github.com/SiddarthaKoppaka/car_deals_search_mcp/issues
MCP Protocol: https://modelcontextprotocol.io

Car Deals Search MCP Server

Car Deals Search MCP

🚀 Quick Start

Prerequisites

Installation

Using with MCP Clients

Testing Standalone

✨ Features

📊 Supported Sources

🔧 MCP Tool: search_car_deals

Parameters

Example Response

🛠️ Technical Details

Chrome/Chromium Requirement

🧪 Development & Testing

🤝 Contributing

📄 License

🔗 Links

Car Deals Search MCP

🚀 Quick Start

Prerequisites

Installation

Using with MCP Clients

Testing Standalone

✨ Features

📊 Supported Sources

🔧 MCP Tool: search_car_deals

Parameters

Example Response

🛠️ Technical Details

Chrome/Chromium Requirement

🧪 Development & Testing

🤝 Contributing

📄 License

🔗 Links

🔧 MCP Tool: `search_car_deals`

🔧 MCP Tool: `search_car_deals`