MCP Server Documentation

Welcome to Vehicle Databases API's Documentation

MCP Server

We now offer a fully integrated Model Context Protocol (MCP) server wrapper, allowing you to bridge our industry-leading vehicle intelligence tools directly into your localized AI workflows, autonomous developer agents, and LLM orchestration environments (such as Claude Desktop, Cursor, or LangChain).

By connecting our MCP server, your AI client can seamlessly invoke actions like decoding VINs, inspecting title statuses, tracking auction histories, and managing US license plates natively within its prompt loop context window.

Technical Architecture

Our server utilizes the modern FastMCP framework running over a high-performance Streamable HTTP (Event-Stream) transport architecture layer. Transactions utilize JSON-RPC 2.0 wrapped tracking envelopes with server-sent response chunking to minimize context assembly latency.

The MCP server is designed to be a drop-in wrapper around our existing RESTful API endpoints, meaning you can leverage all of our current API functionality with minimal adjustments to your existing integration logic. The server handles the translation of MCP requests into RESTful calls and manages the response streaming back to your AI client.

Provided Tools Summary

  • AdvancedVINDecode: Access premium vehicle specifications by VIN and YMMT.
  • Auction: Access auction history records through Auction API.
  • BasicDecode: Get basic vin decoder data from a VIN number.
  • EuropeDecode: Access European vehicle specifications with the Europe VIN decoding API.
  • LicensePlateDecode: Decode US license plates to get vehicle information.
  • MotorcycleVINDecode: Access the motorcycle specifications with VIN decoding API Args: vin: Vehicle Identification Number (17 characters) Returns: Dictionary with motorcycle vin decode information
  • SalesHistory: Decode VIN to get sales history data..
  • StolenCheck: Decode VIN to find if vehicle has stolen or not.
  • TitleCheck:Decode VIN to find if vehicle has title label or clean.
  • UKRegistrationDecode: Decode REG number to access information about a UK registration number, including its year, make, model, and more details.
  • USPlateDecode: Decode US license plate to access information about a US license plate, including its year, make, model, and more details.
  • VINSuggestion: Decode VIN to get vin suggestions..
  • VehicleMaintenance: Access the service and maintenance schedules information of a vehicle Args: vin: Vehicle Identification Number (17 characters) Returns: Dictionary with vehicle maintenance information.
  • VehicleRepairs: Access the repair information of a vehicle Args: vin: Vehicle Identification Number (17 characters) Returns: Dictionary with vehicle repair information
  • VehicleWarranty: Access the warranty information of a vehicle Args: year: Vehicle Year make: Vehicle Make model: Vehicle Model Returns: Dictionary with vehicele warranty information.

Connection Configuration

To configure your preferred AI assistant application environment, append the configuration block to your native environment configuration profiles.

{
  "mcpServers": {
    "VDBMCP": {
      "url": "https://mcp.vehicledatabases.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "x-authkey": "YOUR_API_KEY"
      }
    }
  }
}