MCP Server

Connect your AI applications to Cardog's automotive data through our Model Context Protocol (MCP) server. Access vehicle listings, market analysis, recalls, fuel pricing, and charging station data directly from Claude and other AI applications.

Server URL: https://mcp.cardog.io/sse

Quick Start

Claude Code (Recommended)

The fastest way to connect is with the Claude Code CLI:

claude mcp add cardog https://mcp.cardog.io/sse --transport sse

When prompted, enter your API key from cardog.app/account/api.

That's it. Cardog tools are now available in Claude Code. Try:

claude "What's a fair price for a 2022 Toyota RAV4?"

Claude Desktop

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cardog": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.cardog.io/sse"],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your API key. Restart Claude Desktop to load the configuration.

Claude Web/Mobile

Go to Settings → Integrations → Add more
Enter:
- Name: Cardog
- URL: https://mcp.cardog.io/sse
Add your API key when prompted
Enable tools in new chats

Authentication

The MCP server requires a valid Cardog API key. You can provide it via:

Method	Format
Query Parameter	`?api_key=YOUR_API_KEY`
Authorization Header	`Authorization: Bearer YOUR_API_KEY`
Custom Header	`x-api-key: YOUR_API_KEY`

Get your API key from your account dashboard.

Available Tools

Inventory & Listings

Tool	Description
`search_listings`	Search vehicle inventory with filters for make, model, year, price, mileage, body style, fuel type, and color

Market Intelligence

Tool	Description
`get_vin_analysis`	Comprehensive market analysis for a specific VIN including pricing position and comparable vehicles
`overview`	Market statistics for a make/model/year: median price, inventory count, price ranges
`price_distribution`	Price histogram data showing where listings cluster
`get_odometer_analysis`	Mileage vs price correlation for depreciation analysis
`get_geographic_analysis`	Regional price variations by state/province
`get_market_trends`	Time series data showing pricing movements
`get_listing_market_position`	Individual listing market analysis
`pulse`	Overall market health indicators

Vehicle Research

Tool	Description
`search_lineups`	Available models for a manufacturer
`get_model_year`	Detailed trim levels and specifications for a specific model year
`search_recalls`	Safety recalls from NHTSA (US) and Transport Canada

Energy & Infrastructure

Tool	Description
`search_electric_stations`	EV charging stations with connector type and power filtering
`search_gas_stations`	Fuel stations with current prices

Example Usage

Finding Vehicles

You: "Find me a used Toyota RAV4 under $30,000 with less than 50,000 miles"

Claude will call search_listings with appropriate filters and return matching vehicles with price, mileage, year, trim level, and dealer information.

Market Analysis

You: "What's the market like for 2022 RAV4s?"

Claude calls overview and responds with market statistics: median price, inventory count, price ranges, and percentile breakdowns.

VIN Check

You: "Check this VIN: 2T3P1RFV8NC123456"

Claude decodes the VIN, identifies the exact vehicle configuration, and provides market positioning relative to comparable listings.

Safety Research

You: "Are there any recalls on 2020-2023 Honda CR-Vs?"

Claude searches NHTSA and Transport Canada databases, listing active recalls with campaign numbers, affected components, and remedy status.

Tips

Unit Conversion

The API uses kilometers for odometer values. Claude automatically converts when you mention miles (50,000 miles ≈ 80,000 km).

VIN Validation

VINs are 17 characters and cannot contain I, O, or Q. Position 9 is a check digit. Claude validates VINs before making API calls.

Combining Tools

The most powerful queries combine multiple tools:

Search → Find matching vehicles
Overview → Compare prices to market statistics
Recalls → Check safety history
Odometer Analysis → Understand depreciation

Building Custom Agents

For programmatic use, see our guide: Building a Car Buying Agent with Claude

You can also call the Cardog API directly with the same data available through MCP tools.

Support

Documentation: docs.cardog.app
API Status: status.cardog.app
Email: support@cardog.app