Home/Developers/MCP Servers
Model Context Protocol

Connect Claude, Cursor, VS Code Copilot, and other AI tools directly to your Carfluence data through the Model Context Protocol. Let AI agents query inventory, analyze markets, and manage integrations.

claude_desktop_config.json
{
  "mcpServers": {
    "carfluence-inventory": {
      "command": "npx",
      "args": ["-y", "@carfluence/mcp-inventory"],
      "env": {
        "CARFLUENCE_API_KEY": "cf_live_xxxx...",
        "CARFLUENCE_API_URL":
          "https://api.carfluence.io/api/v1"
      }
    }
  }
}

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants connect to external data sources and tools. Instead of copy-pasting data into prompts, MCP gives AI direct, structured access to your live data.

AI-Native

AI agents call tools and read resources directly. No manual data wrangling or prompt engineering needed.

Scoped Access

Each MCP server uses your API key with specific scopes. The AI only sees what you allow.

Real-Time Data

Every query hits live data. No stale exports or cached snapshots. Always up-to-date.

Available Servers

Three specialized MCP servers for different use cases

Let AI agents query, search, and manage your vehicle inventory in real-time. Access vehicle details, pricing, lifecycle data, and change history through natural language.

Available Tools (6)

search_inventory

Search vehicles by make, model, year, price range, status, or free text

Params: query, filters (status, make, model, year_min, year_max, price_min, price_max), limit
get_vehicle

Get complete details for a specific vehicle by VIN

Params: vin
get_vehicle_history

Get price changes, status transitions, and field update history

Params: vin, limit
get_inventory_stats

Get aggregate statistics: total count, active/sold, new/used, avg price

Params: integration_id (optional)
get_lifecycle_stats

Get lifecycle analytics: avg days on lot, at-risk vehicles, relisted count

Params: integration_id (optional)
list_dealers

List all dealerships with vehicle counts and status

Params: status, search

Resources

carfluence://inventory/summaryCurrent inventory summary with key metrics
carfluence://inventory/vehiclesPaginated vehicle listing
carfluence://dealers/listAll dealer profiles with metadata

Configuration

{
  "mcpServers": {
    "carfluence-inventory": {
      "command": "npx",
      "args": [
        "-y",
        "@carfluence/mcp-inventory"
      ],
      "env": {
        "CARFLUENCE_API_KEY": "cf_live_xxxxxxxxxxxx",
        "CARFLUENCE_API_URL": "https://api.carfluence.io/api/v1"
      }
    }
  }
}

Setup Guide

Configure MCP servers in your AI tool of choice

Quick Start

1

Get your API key

Sign up at app.carfluence.io and create an API key with the scopes you need (e.g., inventory:read for the Inventory MCP server).

2

Choose your MCP server

Pick the server that matches your use case: Inventory for vehicle data, Analytics for market insights, or Integration for managing data sources.

3

Add to your config file

Copy the JSON configuration and add it to your AI tool's MCP config file. Replace the API key placeholder with your real key.

4

Restart and verify

Restart your AI tool. You should see the Carfluence tools available in the tool list. Try asking: "What's my current inventory count?"

claude_desktop_config.json

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

windows: %APPDATA%\Claude\claude_desktop_config.json

linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "carfluence-inventory": {
      "command": "npx",
      "args": [
        "-y",
        "@carfluence/mcp-inventory"
      ],
      "env": {
        "CARFLUENCE_API_KEY": "cf_live_xxxxxxxxxxxx",
        "CARFLUENCE_API_URL": "https://api.carfluence.io/api/v1"
      }
    },
    "carfluence-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@carfluence/mcp-analytics"
      ],
      "env": {
        "CARFLUENCE_API_KEY": "cf_live_xxxxxxxxxxxx",
        "CARFLUENCE_API_URL": "https://api.carfluence.io/api/v1"
      }
    },
    "carfluence-integration": {
      "command": "npx",
      "args": [
        "-y",
        "@carfluence/mcp-integration"
      ],
      "env": {
        "CARFLUENCE_API_KEY": "cf_live_xxxxxxxxxxxx",
        "CARFLUENCE_API_URL": "https://api.carfluence.io/api/v1"
      }
    }
  }
}

What Can You Build?

Example conversations with Carfluence MCP servers

"Show me all vehicles that have been on the lot for more than 60 days"

Inventory

Uses search_inventory with days_on_lot filter to find aging inventory across all dealerships.

"Show me all unanswered calls from last week"

Analytics

Calls query_calls with status=missed, direction=inbound, and date range for the past 7 days. Returns caller numbers, tracking sources, and timestamps.

"How many internet leads did we get this month?"

Analytics

Uses query_leads with type=internet and the current month date range. Returns total count, breakdown by source (Paid Search, Organic, etc.), and conversion rates.

"Are there any sync errors in the last 24 hours?"

Integration

Queries get_sync_logs across all integrations and surfaces any failed or partially completed syncs.

"What is our cost per lead from Google Ads vs Facebook this quarter?"

Analytics

Combines query_leads with source filters and get_source_summary to compare cost-per-lead across advertising platforms for the current quarter.

"Create a summary of inventory changes this week for the dealer meeting"

Inventory + Analytics

Combines get_lifecycle_stats, get_inventory_stats, query_sales, and get_sold_analysis to generate a comprehensive weekly report with sales performance.

Give Your AI Superpowers

Connect your AI assistant to live automotive data in under 5 minutes.