# Kavak MCP

> Kavak connects your AI agent directly to Mexico's largest certified used car marketplace. Search, inspect, finance, and trade in vehicles—all through conversation. Get instant valuations for your current car or check a vehicle’s full ownership history without ever clicking away from your chat window.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** used-cars, vehicle-inspection, automotive-marketplace, financing, vehicle-valuation, inventory-search

## Description

Buying a used car shouldn't feel like detective work. With this MCP, you connect your AI client to Kavak and navigate Mexico's entire pre-owned vehicle catalog using natural conversation. You can start by finding what you need—filtering thousands of cars by model, year, or price range. The agent handles the browsing, pulling up full details for any specific car. Need to know if it’s legit? You check the 240-point mechanical inspection report and review the vehicle's complete history, including accident records and ownership count. Selling your current ride is just as easy; you get an instant buy-back estimate based on its make, model, mileage, and condition. Need cash flow for the purchase? The system calculates available credit plans across multiple terms. All this functionality—from getting market price intelligence to scheduling a test drive or reserving a unit—is accessible through your agent. It’s all managed within Vinkius, so you don't have to juggle multiple specialized connectors just to buy a car.

## Tools

### create_reservation
Reserves a specific car by taking it off the marketplace temporarily, requiring the buyer's contact info.

### estimate_trade_in
Provides an instant valuation for your current vehicle based on its make, model, mileage, and condition in the Mexican market.

### get_financing_options
Calculates various credit payment plans (monthly payments, rates) for a chosen vehicle.

### get_vehicle_history
Checks and returns a detailed record of ownership changes, accident reports, and service history for a vehicle.

### get_vehicle_inspection
Displays the full 240-point mechanical inspection report that Kavak performs on every car.

### get_market_pricing
Retrieves current average pricing and trend data for specific car makes and models in the used market.

### get_reservation
Checks if a previously placed vehicle reservation is still active or needs attention.

### get_vehicle
Retrieves comprehensive details for any specific car listed on the marketplace.

### list_locations
Finds nearby Kavak showroom locations, including operating hours and services like test drives or inspections.

### list_makes
Returns a list of all car manufacturers currently available in the inventory.

### list_models
Lists specific models that are available for selection under a given manufacturer.

### list_reservations
Shows all active purchase reservations made by the user account.

### schedule_test_drive
Arranges a test drive for a car, including options for home delivery in select cities.

### search_vehicles
Initiates a search across the entire inventory to find available used cars based on user criteria.

## Prompt Examples

**Prompt:** 
```
Find me Toyota Corollas from 2020-2023 under $350,000 MXN.
```

**Response:** 
```
I found 8 Toyota Corollas matching your criteria: 1. 2022 Corolla SE — $329,000 MXN (42,000 km, automatic, silver). 2. 2021 Corolla LE — $298,000 MXN (58,000 km, automatic, white). 3. 2020 Corolla Base — $265,000 MXN (71,000 km, manual, gray). All include Kavak's 240-point inspection and 3-month warranty. Would you like to see the inspection report or financing options for any of these?
```

**Prompt:** 
```
What would Kavak offer me for my 2019 Nissan Sentra with 85,000 km?
```

**Response:** 
```
Based on Kavak's AI valuation engine, your 2019 Nissan Sentra (85,000 km, assumed 'good' condition) has an estimated trade-in value of $178,500 MXN. The current Kavak selling price for equivalent models is $215,000-$235,000 MXN. This offer is valid for 7 days. Would you like to proceed with the trade-in process or browse vehicles to buy with the trade-in credit?
```

**Prompt:** 
```
Show financing options for vehicle ID KV-88201 with a $50,000 MXN down payment.
```

**Response:** 
```
Financing options for KV-88201 (2022 Mazda 3 — $345,000 MXN) with $50,000 enganche: 12 months: $27,100/mo (12.9% rate, CAT 16.2%). 24 months: $14,500/mo (13.9% rate, CAT 17.5%). 36 months: $10,300/mo (14.5% rate, CAT 18.8%). 48 months: $8,250/mo (15.2% rate, CAT 19.5%). 60 months: $7,100/mo (15.9% rate, CAT 20.1%). Would you like to reserve this vehicle?
```

## Capabilities

### Search and filter vehicles
Find specific cars in the inventory by filtering criteria like make, model, year, or price range.

### Check mechanical inspection reports
View the detailed 240-point mechanical inspection results for any listed vehicle.

### Get ownership and accident history
Pull up a car's complete record, including how many owners it has had and if there were any reported accidents.

### Estimate trade-in value for your current car
Receive an instant valuation offer for the vehicle you currently own based on its details and local market rates.

### Calculate financing options
See available credit plans broken down by different loan terms, including required down payments.

### Manage test drives and reservations
Schedule a test drive at a local hub or reserve the vehicle for purchase using your contact details.

## Use Cases

### Determining if a car is worth buying
A buyer finds an appealing vehicle ID. They ask their agent to run `get_vehicle` and then follow up by requesting the `get_vehicle_history` and `get_vehicle_inspection`. This confirms it's accident-free and mechanically sound before they commit to anything.

### Calculating a complete purchase budget
A financial advisor has a client car. They first run `estimate_trade_in` for the client’s current ride, then ask the agent to find potential replacements using `search_vehicles`. Finally, they use `get_financing_options` on the top pick to present a complete budget.

### Finding inventory and setting up a test drive
A user knows their desired make but isn't sure of models. They first call `list_makes` and then use `list_models`. Once they find the right model, they can `search_vehicles` to see available units and then `schedule_test_drive`.

### Analyzing local market trends
A dealer wants to know if a specific vehicle type is rising or falling in value. They use `get_market_pricing` for that make/model combination, giving them the data needed for better pricing strategy.

## Benefits

- You stop wasting time scrolling through thousands of listings. Instead, use `search_vehicles` to narrow down exactly what you need in seconds.
- Don't trust a single seller’s word. Check the full details using `get_vehicle_history` and view the required 240-point inspection report with `get_vehicle_inspection`.
- Need to know if your trade-in is worth it? Just run `estimate_trade_in`. You get an instant, AI-powered buy-back offer without visiting a lot.
- Compare purchase power easily. Use `get_financing_options` to instantly view credit plans for any vehicle across multiple loan terms.
- Know the market value before you commit. Run `get_market_pricing` to see what comparable models are selling for right now, keeping you from overpaying.

## How It Works

The bottom line is you get full access to Kavak’s sales tools and market data without having to navigate their website yourself.

1. First, subscribe to this MCP in Vinkius and enter your required Kavak API Key and Secret.
2. Next, prompt your AI client with a request, like 'Show me used SUVs under $300,000 MXN.'
3. The system returns specific data, whether it's a list of options or a detailed report for one car.

## Frequently Asked Questions

**How do I find out if a specific vehicle has been in an accident using get_vehicle_history?**
Running `get_vehicle_history` provides the complete record. It tells you about ownership count and specifically flags any reported accidents or legal status changes.

**I want to know what my car is worth right now, so I should use estimate_trade_in?**
Yes, `estimate_trade_in` runs an instant analysis using your vehicle’s make, model, mileage, and current market data to give you a solid buy-back offer.

**Can I schedule a test drive without knowing the location first?**
No. First, use `list_locations` to find a nearby Kavak showroom or hub. Then, use that specific location data when calling `schedule_test_drive`.

**What is the best way to start looking for cars in this MCP?**
Start with `search_vehicles`. You can feed it criteria like price range and model, which returns a list of available units you can then investigate further.

**What credentials are necessary to run the `list_locations` tool?**
You need a valid Kavak API Key and Secret. These keys authenticate your request and grant access to location data, including addresses, operating hours, and service details.

**When using `search_vehicles`, what is the required format for filtering by make or model?**
You must provide a specific Make ID and Model ID. The search function accepts general text queries but requires these IDs to accurately narrow down the inventory list.

**Do I need to call `get_vehicle` before running `get_financing_options`?**
Yes, you must first get the full details of the specific car using `get_vehicle`. The financing tool requires a unique vehicle identifier from that initial retrieval step.

**What happens if I try to run the `create_reservation` tool for an already booked car?**
The system will return a status code indicating 'Reservation Conflict.' This means the specific vehicle is currently off-market or has been reserved by another user.

**Can I get an instant trade-in offer for my current car?**
Yes! Use the `estimate_trade_in` tool with your car's make, model, year, mileage, and condition. Kavak's AI valuation engine will return an instant buy-back offer based on current Mexican market conditions and comparable recent transactions.

**What does the 240-point inspection cover?**
Use `get_vehicle_inspection` to see the full 240-point report. It covers engine health, transmission status, brake system, tire condition, electrical systems, suspension, body/paint integrity, interior condition, and all safety features. Each point is rated as pass, warning, or replaced.

**Can I calculate monthly payments for different financing scenarios?**
Yes. Use `get_financing_options` with the vehicle ID and an optional down payment amount (enganche). It returns a matrix of monthly payment options across 12, 24, 36, 48, and 60-month terms, each with interest rates, total cost, and CAT (Costo Anual Total).