What is the CarsXE integration for Google ADK?

The CarsXE MCP server brings the full suite of CarsXE vehicle data APIs into your Google Agent Development Kit (ADK) agents through a single remote endpoint at https://mcp.carsxe.com/mcp. Your agents can decode VINs and license plates, retrieve market values and ownership history, check safety recalls, and diagnose trouble codes — all from natural language queries, with no local install.

ADK Integration Page: adk.dev/integrations/carsxe

MCP Endpoint: https://mcp.carsxe.com/mcp

Key use cases

• Vehicle identification — turn VINs or license plates into structured data: make, model, year, engine, trim, and equipment specifications.
• Vehicle assessment — market valuations, ownership histories, and active safety recall information to inform purchasing and servicing decisions.
• Diagnostic support — convert OBD-II trouble codes (like P0300) into readable definitions and probable causes.
• Image processing — extract vehicle identifiers from photos and retrieve visual media by make and model.

Prerequisites

Before you begin, ensure you have:

1. An installed ADK environment
2. A CarsXE API key — get one from the CarsXE developer dashboard

Installation

The integration connects to the hosted CarsXE MCP server over streamable HTTP — there is nothing to install locally. Add the McpToolset to your agent and pass your CarsXE API key via the X-API-Key header.

Python

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

CARSXE_API_KEY = "YOUR_CARSXE_API_KEY"

root_agent = Agent(
    model="gemini-flash-latest",
    name="carsxe_agent",
    instruction="You are a vehicle data assistant...",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mcp.carsxe.com/mcp",
                headers={"X-API-Key": CARSXE_API_KEY},
            ),
        )
    ],
)

TypeScript

import { LlmAgent, MCPToolset } from "@google/adk";

const CARSXE_API_KEY = "YOUR_CARSXE_API_KEY";

const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "carsxe_agent",
    instruction: "You are a vehicle data assistant...",
    tools: [
        new MCPToolset({
            type: "StreamableHTTPConnectionParams",
            url: "https://mcp.carsxe.com/mcp",
            transportOptions: {
                requestInit: {
                    headers: { "X-API-Key": CARSXE_API_KEY },
                },
            },
        }),
    ],
});

Available tools

Authentication

The integration uses header-based authentication. Send your CarsXE API key in the X-API-Key header on every request to the hosted MCP server over a streamable HTTP connection — no local installation required.

If you do not have a key yet, sign up and get one from the CarsXE developer dashboard.

Usage examples

Once the toolset is attached, your ADK agent invokes CarsXE tools automatically when it detects relevant context. For example:

• "What can you tell me about VIN WBAFR7C57CC811956?" — calls get-vehicle-specs
• "Does this car have any open recalls? VIN: WBAFR7C57CC811956" — calls get-vehicle-recalls
• "My check engine light is on with code P0300" — calls decode-obd-code
• "How much is a 2012 BMW X5 worth?" — calls get-market-value

API documentation

Full API documentation is available at api.carsxe.com/docs.