🤖 MCP Integration

    Model Context Protocol (MCP) Integration

    CarJam provides a Model Context Protocol (MCP) integration that allows AI assistants to access comprehensive vehicle information through a standardized interface. This integration enables AI systems to retrieve detailed vehicle data using just a license plate or VIN.

    What is MCP?

    The Model Context Protocol (MCP) is a standardized way for AI assistants to securely connect to data sources and tools. CarJam's MCP server provides access to comprehensive vehicle information that AI systems can easily understand and use.

    What Information Can You Get?

    The CarJam MCP integration provides access to extensive vehicle information including:

    Basic Vehicle Information

    • Vehicle Details: Make, model, year, body style, color, engine specifications
    • Registration: VIN, registration status, country of origin, first registration date
    • Technical Specs: Engine details, fuel type, seating capacity, weight specifications

    Licensing & Compliance

    • License Status: License type, number, expiry dates, issue dates
    • WOF/COF Status: Inspection dates, results, expiry dates, compliance status
    • RUC Information: Road user charges, license history, hubodometer details

    Ownership History

    • Current Owner: Registration details, ownership date, party type
    • Previous Owners: Complete ownership history with dates, odometer readings
    • Ownership Changes: Timeline of ownership transfers, trading names, addresses

    Financial Information

    • Money Owing: PPSR search results for outstanding finance
    • Security Interests: Financial encumbrances, liens, security interests
    • Historical Finance: Past financial obligations and their resolution

    Vehicle Condition & History

    • Odometer History: Usage statistics, mileage progression over time
    • Inspection Results: WOF/COF inspection history and results
    • Damage Warnings: Fire/water/structural damage write-off warnings
    • Recalls & Warnings: Compulsory recalls, safety warnings, write-off status

    Market Information

    • Vehicle Valuation: Market value estimates, dealer prices
    • Vehicle Variants: Available specifications and pricing options
    • Market Analysis: Pricing based on current and estimated odometer readings

    Getting Started

    Configuration

    To use CarJam's MCP integration, configure your AI agent with the appropriate MCP settings. The example below shows the configuration for Cursor:

    Cursor Configuration:

    {
  "mcpServers": {
    "carjam": {
      "url": "https://www.carjam.co.nz/mcp/",
      "headers": {
        "API-KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

    Other AI Agents: Similar configuration is required for other AI agents that support MCP. Each AI agent may have its own configuration format, but the core requirements remain the same:

    • MCP server URL: https://www.carjam.co.nz/mcp/
    • API key authentication in headers

    API Key

    You'll need a valid CarJam API key to access the MCP integration. API keys can be obtained through your CarJam developer account.

    Endpoint

    The MCP server is available at: https://www.carjam.co.nz/mcp/

    How It Works

    The AI assistant handles all the technical details automatically. You simply ask questions like:

    • "Get me the VIN for plate ABC123"
    • "What's the license and WOF status for this vehicle?"
    • "Who is the current owner?"
    • "How many previous owners are there?"
    • "Are there any money owed on this vehicle?"

    The AI will automatically determine what information to retrieve and present it in a clear, human-readable format.

    Example Usage

    Here's how the integration works in practice:

    User

    Get me the VIN for the plate ABC123

    AI Agent

    I'll help you get the VIN for the plate ABC123 using the CarJam_vehicle_search tool.

    Based on the CarJam search results, here's the VIN for plate ABC123:

    VIN: 1HGBH41JXMN109186

    Additional vehicle information:

    • Make: Honda
    • Model: Civic LX Sedan
    • Year: 2021
    • Body Style: 4 Door Sedan
    • Color: Silver
    • Engine: 1.5L Petrol
    • Registration Status: Active
    • Country of Origin: Japan

    The vehicle was first registered in New Zealand on December 15, 2020, and the last recorded odometer reading was 28,450 km as of November 15, 2024.

    User

    whats the license and WOF status?

    AI Agent

    Based on the CarJam search results for plate ABC123, here's the license and WOF status:

    License Status:

    • License Type: Normal (L)
    • License Number: 210345678
    • License Expiry Date: March 15, 2025
    • Issue Date: March 15, 2024
    • Continuous License: Yes

    WOF Status:

    • Subject to WOF: Yes
    • Subject to WOF Inspection: Yes
    • Latest WOF Inspection Date: September 10, 2024
    • Latest WOF Result: Pass
    • Last Successful WOF Expiry Date: March 10, 2025

    The vehicle's WOF and license are both current and valid.

    User

    how many previous owners are there?

    AI Agent

    I'll search for the complete ownership history to see how many previous owners there have been for plate ABC123.

    Based on the complete ownership history search for plate ABC123, here's the breakdown of previous owners:

    Total Number of Previous Owners: 1

    Here's the complete ownership timeline:

    1. First Owner (2020-12-15): AUCKLAND HONDA LIMITED
      • Date: December 15, 2020
      • Odometer: 15,420 km
      • Trading As: AUCKLAND HONDA
      • Address: 123 Queen Street, Auckland Central, Auckland
      • Status: First registration in NZ

    Current Owner (2023-01-15): Individual (Registration #198765432)

    • Date: January 15, 2023
    • Odometer: 15,420 km
    • Status: Current owner

    So the vehicle has had 1 previous owner before the current owner, with ownership transferring from the dealership to an individual buyer.

    User

    Are there any money owed?

    AI Agent

    I'll search for any money owed or financial encumbrances on plate ABC123 by including PPSR (Personal Property Securities Register) information in the search.

    Based on the PPSR search results for plate ABC123, here's the money owing status:

    Money Owing Status: NO MONEY OWED

    PPSR Search Results:

    • Search Date: December 19, 2024
    • Search Result: Successful (S)
    • Finance Statements Found: 0
    • Money Owing Matches: 0
    • Collateral Matches: 0
    • Match Description: No matches found

    Summary: The PPSR search confirms that there is no money owed on this vehicle. The search found:

    • No outstanding finance agreements
    • No security interests
    • No financial encumbrances
    • No money owing statements

    This means the vehicle is currently free of any financial obligations or liens, and the current owner has clear title to the vehicle with no outstanding debts attached to it.

    Terms and Conditions

    Use of the MCP integration is subject to CarJam's API Terms and Conditions. By using this integration, you agree to comply with all applicable terms and conditions.