---
title: "Google ADK"
description: "Connect the CarsXE MCP server to your Google Agent Development Kit (ADK) agents — decode VINs and plates, get market values, history, recalls, liens, images, and OBD codes with natural language."
canonical_url: "https://docs.carsxe.com/docs/integrations/adk-quickstart"
markdown_url: "https://docs.carsxe.com/docs/integrations/adk-quickstart.md"
last_updated: "1980-01-01"
---

# Google ADK
URL: /docs/integrations/adk-quickstart
LLM index: /llms.txt
Description: Connect the CarsXE MCP server to your Google Agent Development Kit (ADK) agents — decode VINs and plates, get market values, history, recalls, liens, images, and OBD codes with natural language.

Task: Connect the CarsXE MCP server to a Google Agent Development Kit (ADK) agent for vehicle data lookups.
Related: /docs/integrations/adk-quickstart, /docs/integrations/mcp, /docs/get-started#authentication

## 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)](https://google.github.io/adk-docs/) 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](https://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](https://google.github.io/adk-docs/get-started/)
2. A CarsXE API key — get one from the [CarsXE developer dashboard](https://api.carsxe.com/dashboard/developer)

## 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

<CodeGroup title="Python">
```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},
            ),
        )
    ],
)
```
</CodeGroup>

### TypeScript

<CodeGroup title="TypeScript">
```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 },
                },
            },
        }),
    ],
});
```
</CodeGroup>

## Available tools

| Tool | Function |
|------|----------|
| `get-vehicle-specs` | Decode a VIN to full specifications |
| `decode-vehicle-plate` | Extract vehicle data from a license plate |
| `get-market-value` | Determine current vehicle valuation |
| `get-vehicle-history` | Access ownership and accident records |
| `get-vehicle-recalls` | Check active safety recalls |
| `get-lien-theft` | Verify lien and theft status |
| `international-vin-decoder` | Decode non-US VINs |
| `vin-ocr` | Extract a VIN from an image |
| `recognize-plate-image` | Identify a plate in a photo |
| `get-year-make-model` | Retrieve specs by vehicle attributes |
| `get-vehicle-images` | Fetch images by make and model |
| `decode-obd-code` | Translate OBD-II trouble codes |

## 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](https://api.carsxe.com/dashboard/developer).

## 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](/docs).

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).