# Edmunds Automotive Data MCP

> Edmunds MCP gives you deep automotive intelligence straight from any AI client. Decode full 17-digit VINs, list car makes and models, inspect engine specs, and query vehicle styles instantly. Get detailed market valuations like new or used TMV prices without leaving your chat window.

## Overview
- **Category:** databases
- **Price:** Free
- **Tags:** automotive-data, vin-decoder, car-specs, vehicle-database, edmunds-api

## Description

This connector lets your agent access Edmunds' massive database of automotive information directly through natural conversation. Instead of visiting multiple websites to compare features or figure out a car’s value, you just ask. You can decode a VIN or get the total cash price for a new vehicle using simple prompts. Need to know what kind of transmission an older model had? Or perhaps you're building a report that needs every available equipment list for a specific style? This MCP handles it all. By connecting through Vinkius, your agent gets access to this deep inventory alongside thousands of other tools, making it the central hub for automotive data research.

## Tools

### calculate_new_tmv
Determines the Total Market Value (TMV) price for a new vehicle.

### calculate_typically_equipped_used_tmv
Calculates the TMV price for a used car that is typically equipped.

### calculate_used_tmv
Gets the Total Market Value (TMV) price for any standard used vehicle.

### get_color
Retrieves specific color details using a unique ID number.

### get_dealer_reviews
Fetches dealer ratings and consumer reviews based on the dealership's ID.

### get_dealership_franchises
Finds a list of available dealership franchises in a given area.

### get_editorial_make
Provides an overview of a specific car make from editorial sources.

### get_editorial_model
Gives a comprehensive overview for a selected car model.

### get_editorial_model_year
Presents an editorial overview specific to a car's model and year.

### get_editorial_road_tests
Retrieves detailed information about professional road tests for a vehicle.

### get_engines
Lists all available engines that match a specific car style ID.

### list_equipments
Retrieves an exhaustive list of equipment options for vehicles.

### get_expert_content
Pulls specialized expert content based on the car's make, model, and year.

### find_certified_price
Calculates the Total Market Value (TMV) price for a certified pre-owned vehicle.

### get_maintenance_schedule
Provides the recommended maintenance schedule based on a car model year ID.

### get_make_details
Retrieves detailed information about an entire car make, such as BMW or Ford.

### get_makes_count
Returns the total number of available car makes in the database.

### list_makes
Generates a simple list of all available car makes.

### get_makes_with_tco
Lists car makes that have Total Cost of Ownership (TCO) values calculated.

### list_model_years
Returns a list of all model years available in the database.

### list_models
Generates a simple list of all available car models.

### get_models_with_tco
Lists car models that have Total Cost of Ownership (TCO) values calculated.

### get_new_tco_details
Calculates the detailed Total Cost of Ownership (TCO) for a new vehicle.

### get_new_tco
Determines the overall Total Cost of Ownership (TCO) for a brand-new car.

### get_new_tmv_by_msrp_vin
Gets the TMV price for a new vehicle when you know its MSRP and VIN.

### get_new_total_cash_price
Calculates the Total Cash Price a buyer pays for a brand-new car.

### get_photos_by_make_model_year
Finds and retrieves photo sets using a specific make, model, and year combination.

### get_photos_by_style
Retrieves photo sets associated with a specific car style ID number.

### get_recalls
Checks for vehicle recalls tied to a given car model year ID.

### get_reviews_by_make_model_year
Gathers consumer ratings and reviews based on the vehicle's make, model, and year.

### get_reviews_by_style
Collects consumer ratings and reviews associated with a specific car style ID.

### get_safety_by_make_model_year
Retrieves safety rating scores for a vehicle based on its make, model, and year.

### get_safety_by_style
Gets safety ratings associated with a specific car style ID number.

### get_squish_vin
Retrieves full vehicle details using the simplified Squish VIN format.

### list_styles
Generates a list of all unique car styles available in the database.

### submit_dealer_review_comment
Allows you to submit supplementary comments on a dealer review.

### submit_dealer_review
Enables the submission of a complete dealer review for a specific location.

### get_transmissions
Lists all available transmission types that match a car style ID.

### get_used_tco_details
Calculates the detailed Total Cost of Ownership (TCO) for a used vehicle.

### decode_vin
Decodes a full 17-digit VIN to retrieve complete vehicle specifications and details.

### get_years_with_styles
Identifies which model years have specific styles available for a given make and model.

## Prompt Examples

**Prompt:** 
```
List all available car makes.
```

**Response:** 
```
I've retrieved the list of car makes. There are currently over 50 makes available, including Acura, Audi, BMW, Ford, Honda, Toyota, and more. Would you like to get details on a specific make?
```

**Prompt:** 
```
Decode this VIN: 1FTFW1EF5CFAXXXXX
```

**Response:** 
```
Decoding VIN... This vehicle is identified as a Ford F-150. I can fetch more detailed specifications, engine options, or equipment lists for this model if you'd like.
```

**Prompt:** 
```
Get the engine specifications for style ID 401234567.
```

**Response:** 
```
Querying engine specs... For style ID 401234567, the engine is a 3.5L V6 EcoBoost. It features twin-turbocharging, direct injection, and produces 375 horsepower. Let me know if you need transmission or color details as well.
```

## Capabilities

### Decode Vehicle Identification Numbers
You pass a VIN, and the MCP returns all associated vehicle details.

### Calculate Market Values (TMV)
The connector figures out the expected price for vehicles—new, used, or certified—based on various criteria.

### Gather Make and Model Data
You can retrieve lists of car makes, models, model years, and total counts to scope your research.

### Fetch Technical Specifications
The system pulls detailed information like engine types, transmissions available, or color IDs for any given style.

### Review Car History and Safety
You can check safety ratings and recall status for a car model year to assess its reliability.

## Use Cases

### Valuing a Trade-In Vehicle
A dealership manager needs to quickly know the worth of an incoming trade. They ask their agent to calculate the `calculate_used_tmv` for a 2015 SUV, and it returns an immediate price range, letting them negotiate right away.

### Comparing New Car Options
An automotive developer needs to build a tool that shows buyers the total cost. They prompt their agent to run `get_new_total_cash_price` and `get_new_tco`, providing an accurate, instant comparison.

### Verifying Vehicle Identity
A journalist receives a photo of a car with only its VIN. They pass the number to their agent and run `decode_vin`. The result instantly identifies the manufacturer, model, and year, solving the puzzle.

### Researching Engine Options
A content writer is writing an article on a specific vehicle style. They ask for engine options using `get_engines` and get a full list of available engines and their specs without leaving their drafting tool.

## Benefits

- Instead of guessing a vehicle's worth, use `calculate_new_tmv`, `calculate_used_tmv`, or `find_certified_price` to get accurate pricing for any type of used or new car. You know the value before you talk to a buyer.
- When doing deep research, you don’t have to juggle multiple spreadsheets. Use `get_make_details` and `list_makes` to quickly gather comprehensive data on entire brands, keeping your process centralized in one chat window.
- Need to know if a model is safe or what it needs? Check the safety rating with `get_safety_by_make_model_year`, or pull recall history using `get_recalls`. You get critical consumer information fast.
- Building out a product that requires vehicle data, like an IDE plugin, can be tough. Use `decode_vin` to instantly verify everything about any car just by its VIN number.
- You can go beyond basic specs. Pull specialized content using `get_expert_content` or check the full maintenance schedule with `get_maintenance_schedule`. It's deep-dive data, not surface level stuff.

## How It Works

The bottom line is, your agent turns complex, multi-step database research into simple conversation.

1. First, you connect your Edmunds API key to the MCP via Vinkius.
2. Next, you tell your agent what automotive data you need—for example, 'Find the engine specs for a 2018 Honda CR-V.'
3. The MCP executes the necessary query and returns structured data containing specific details like horsepower or transmission type.

## Frequently Asked Questions

**How do I decode a VIN using Edmunds MCP?**
You simply ask your agent to use `decode_vin` and provide the full 17-digit number. The MCP returns all known details about that specific vehicle, including its manufacturer, model, and year.

**Can Edmunds MCP tell me if a car is safe?**
Yes. Use `get_safety_by_make_model_year` to pull the safety rating scores for any given car's make, model, and specific year.

**How do I find out the price of a used car with Edmunds MCP?**
To get a current valuation, run `calculate_used_tmv` or, if it’s certified pre-owned, use `find_certified_price`. The agent handles which calculation is best.

**Does Edmunds MCP provide engine details?**
Yes. You can retrieve a list of available engines for any car style using the `get_engines` tool, giving you specs like horsepower and displacement.

**What makes this better than just searching Google for Edmunds data?**
Google gives links; this MCP gives structured JSON data. You get clean, actionable data that your agent can immediately use to build a report or run calculations against.