MCP Server Documentation

Welcome to Vehicle Databases API's Documentation

MCP Server

Overview

The Vehicle Databases MCP (Model Context Protocol) Server provides a standardized interface for AI assistants to securely access trusted automotive data. By connecting your MCP-compatible client to our server, you can interact with Vehicle Databases APIs through natural language conversations instead of writing custom API integrations.

MCP works with Claude Desktop, Cursor, Cline, Windsurf, VS Code MCP, and other compatible AI assistants. Your AI client handles tool selection, parameter passing, and response formatting automatically.

How It Works

The MCP server acts as a bridge between your AI assistant and Vehicle Databases APIs. When you ask a question, your AI assistant determines which tools are needed, sends requests through the MCP server, and returns a complete response — without you needing to manually call endpoints or parse API responses.

Setup Instructions

To connect your AI assistant to the Vehicle Databases MCP Server, follow these steps:

  1. Create an account — Sign up at vehicledatabases.com and generate an API key from your dashboard.
  2. Configure your MCP client — Add the following configuration block to your AI client's MCP settings file (e.g., cline_mcp_settings.json or mcp.json):
    {
      "mcpServers": {
        "VDBMCP": {
          "url": "https://mcp.vehicledatabases.com/mcp",
          "transport": "streamable-http",
          "headers": {
            "x-authkey": "YOUR_API_KEY"
          }
        }
      }
    }
  3. Replace the API key — Replace YOUR_API_KEY with your actual Vehicle Databases API key.
  4. Restart your AI client — After saving the configuration, restart your AI assistant to establish the connection.

Available Endpoints

The MCP server exposes the following tools for AI assistants to use. Each tool maps to a corresponding Vehicle Databases API endpoint.

ToolDescription
AdvancedVINDecodeAccess premium vehicle specifications by VIN and YMMT
AuctionAccess auction history records
BasicDecodeBasic VIN decoder data from a VIN number
BuildsheetFactory build sheet information
EuropeDecodeEuropean vehicle specifications via VIN decoding
LicensePlateDecodeDecode US license plates to get vehicle information
MarketValueEstimated current market value of a vehicle
MotorcycleVINDecodeMotorcycle specifications via VIN decoding
SalesHistoryHistorical auction and sales information
StolenCheckCheck if a vehicle has been reported stolen
TitleCheckCheck vehicle title labels or clean status
UKRegistrationDecodeDecode UK registration numbers
USPlateDecodeDecode US license plates
VINSuggestionVIN suggestions and validation
VehicleHistoryComplete vehicle history reports
VehicleMaintenanceService and maintenance schedules
VehicleRepairsVehicle repair information
VehicleWarrantyVehicle warranty information
WindowStickerOriginal factory window sticker (Monroney label)
YMMTSpecificationsYear/Make/Model/Trim specifications

Additional tools are continuously added to the platform.

Supported Clients

The Vehicle Databases MCP Server is compatible with any application that supports the Model Context Protocol, including:

  • Claude Desktop — Anthropic's desktop application
  • Cursor — AI-powered code editor
  • Cline — Autonomous coding agent for VS Code
  • Windsurf — AI-powered IDE
  • VS Code MCP — VS Code extensions supporting MCP
  • Antigravity — Google's desktop application

Pricing

There is no additional fee for using the MCP server. MCP requests consume the same API credits as standard Vehicle Databases API requests, so existing API customers can start using MCP immediately.

Frequently Asked Questions

Support

If you have questions about setup, supported AI clients, or integrating the Vehicle Databases MCP Server into your workflow, please contact our support team.