Skip to main content
Glama
cox-automotive-mcp

cox-automotive-mcp

by sanjibani

cox-automotive-mcp

First MCP server for the auto-dealership vertical. Lets Claude, Cursor, or any MCP client read dealer accounts, look up manufacturer incentives, and manage inventory listings through the Cox Automotive / Dealer Developer Portal API.

Cox Automotive is the umbrella for the auto-dealership ecosystem — Dealer.com (websites + digital marketing), vAuto (inventory + pricing), Dealertrack (DMS + financing), VinSolutions (CRM), and more. This MCP covers the publicly-documented Dealer Developer Portal API surface (Accounts, Incentives, Inventory). Other Cox brands expose additional partner-gated APIs that will be added as their surfaces become publicly documented.

Why this exists

17,000+ US auto dealerships depend on Cox Automotive for daily operations. There's no MCP for the vertical. Existing AI tooling targets generic CRMs (HubSpot, Salesforce) that dealers don't run. This is the first.

Related MCP server: pipedriver

12 tools

Tool

What it does

health_check

Verify COX_AUTO_API_KEY works.

list_accounts

Paginated list of dealer accounts the API key can access.

iter_accounts

Flat list of all accounts (auto-paginates).

get_account

One dealer account by id.

list_incentives

Paginated incentives (rebates, finance offers) for an account.

get_incentive

One incentive by id within an account.

search_incentives

Filter incentives by vehicle make/model/year.

list_inventory

Paginated vehicles in a dealer's inventory.

iter_inventory

Flat list of all inventory vehicles (auto-paginates).

get_vehicle

One vehicle listing by id.

create_vehicle

Add a vehicle to inventory.

update_vehicle

Update fields on a vehicle (price, mileage, photos, status).

delete_vehicle

Remove a vehicle from inventory.

search_inventory

Filter inventory by make/model/year/price range.

Install

pip install cox-automotive-mcp

Or from source:

git clone https://github.com/sanjibani/cox-automotive-mcp
cd cox-automotive-mcp
pip install -e ".[dev]"

Configure

export COX_AUTO_API_KEY=<your-dealer-developer-portal-api-key>

Get your API key by registering at https://developer.inv.dealer.com (My Account → Register). Cox Automotive's Mashery-backed API uses header-based API keys.

Optional overrides:

  • COX_AUTO_BASE_URL — change the API base (sandbox, regional)

  • COX_AUTO_AUDIT_LOG — JSONL audit log file path (defaults to stderr)

Run

cox_automotive_mcp

Add to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "cox-automotive": {
      "command": "cox_automotive_mcp",
      "env": {
        "COX_AUTO_API_KEY": "your-key-here"
      }
    }
  }
}

Example prompts

Once connected to your MCP client:

  • "Show me every dealer account this API key has access to."

  • "What Honda Civic 2024 incentives are available for dealer 1042?"

  • "List all vehicles under $25,000 in dealer 1042's inventory."

  • "Add this 2023 Toyota Camry I just took in: VIN 4T1B11HK5KU123456, 18,500 miles, asking $24,995, stock number P1042-12."

  • "Vehicle 9001 just had new photos taken — update the photo URL to https://cdn.example.com/9001-v2.jpg."

  • "Vehicle 9017 sold. Remove it from inventory."

Architecture

Built on the mcp-vertical-template industry-leading patterns:

  • Shared httpx.AsyncClient with connection pooling (100 max, 20 keepalive) + transport-level retries

  • Typed exception hierarchy (CoxAutomotiveAuthError, RateLimitError, NotFoundError, APIError, ConnectionError) with structured fields (http_status, error_code, request_id, retry_after, body)

  • Application-level retry with exponential backoff + full jitter, honoring Retry-After

  • Auto-paginating iterators (iter_accounts, iter_inventory, iter_incentives) that walk the page/pageSize cursor without caller math

  • isError-compliance — every MCP tool raises on failure so FastMCP sets isError: true on the wire (Blackwell Systems audit pattern; agents can't retry indefinitely on errors they can't see)

  • JSONL audit logging to stderr (or COX_AUTO_AUDIT_LOG file) — SOC2 baseline for B2B procurement

  • Property-based tests (Hypothesis) for JSON round-trips

  • Strict mypy + full ruff rule set + pytest with respx HTTP mocking

Development

git clone https://github.com/sanjibani/cox-automotive-mcp
cd cox-automotive-mcp
pip install -e ".[dev]"
pytest                    # unit + integration mocks
ruff check src tests      # lint
ruff format --check src tests  # format
mypy src                  # strict type-check

Test coverage is enforced at 80% via pytest --cov.

This is part of a portfolio of vertical MCP servers from the same author. See https://github.com/sanjibani?q=-mcp for the full list, including legal (PracticePanther), insurance (HawkSoft), dental (Open Dental), veterinary (ezyVet), home service (Jobber), church / nonprofit (Realm ACS), and the shared scaffolding template.

For custom MCP server engagements, see https://sanjibani.github.io/mcp-services/.

License

MIT — Sanjibani Choudhury schoudhury1991@gmail.com

Available Tools

14 tools
create_vehicleA

Add a new vehicle to a dealer's inventory.

Use when: "I just took in a 2023 Toyota Camry — add it to dealer 1042's lot." Example: account_id=1042, vin="1HGCM82633A123456", make="Honda", model="Civic", year=2024, mileage=12500, price=24995, stock_number="P1042-7" → creates the listing and returns the new vehicle record.

Inputs: vin (required), make (required), year (required), model (required), +4 more. Returns: result

delete_vehicleA

Remove a vehicle from inventory.

Use when: "vehicle 9001 sold, remove it." Example: vehicle_id=9001 → {"status": "deleted", "vehicleId": 9001}.

Inputs: vehicle_id (required). Returns: result

get_accountA

Fetch one dealer account by id.

Use when: "what's the phone number for dealer 1042?" or "show me account 1042". Example: account_id=1042 returns account record with name, dealerCode, phone, etc.

Inputs: account_id (required). Returns: result

get_incentiveA

Fetch one incentive by id within a dealer's account.

Use when: "what's the full text of incentive 5821 for dealer 1042?" Example: account_id=1042, incentive_id=5821 → full incentive detail.

Inputs: account_id (required), incentive_id (required). Returns: result

get_vehicleA

Fetch one vehicle listing by id.

Use when: "show me full details on vehicle 9001." Example: vehicle_id=9001 → full vehicle record.

Inputs: vehicle_id (required). Returns: result

health_checkA

Verify credentials work. If this fails, all other tools will too.

Use when: starting a session or troubleshooting auth errors. Example: call first, expect {"status": "ok"} — if not, re-check COX_AUTO_API_KEY.

Inputs: no named parameters. Returns: result

iter_accountsA

Yield dealer accounts across all pages as a flat JSON array.

Use when: "give me every dealer account this key has access to" (no pagination math). Example: returns [{"accountId": 1001, "name": "Smith Honda", ...}, ...].

Inputs: no named parameters. Returns: result

iter_inventoryA

Yield all inventory vehicles for a dealer account as a flat JSON array.

Use when: "every vehicle on the lot" without pagination math. Example: account_id=1042 → [{"vehicleId": 9001, "vin": "...", ...}, ...].

Inputs: account_id (required). Returns: result

list_accountsA

List dealer accounts the API key can access (paginated).

Use when: "show me my dealer accounts" or "what stores does this API key cover?" Example: page=1, page_size=50 → returns one page of accounts with envelope metadata. For the flat list, see iter_accounts.

Inputs: page, page_size. Returns: result

list_incentivesA

List incentives (rebates, finance offers) for a dealer account.

Use when: "what rebates are available for dealer 1042 this month?" Example: account_id=1042, page=1 → first page of incentives with envelope.

Inputs: account_id (required), page, page_size. Returns: result

list_inventoryA

List vehicles in a dealer's inventory (paginated).

Use when: "what's on the lot at dealer 1042?" Example: account_id=1042, page=1, page_size=50 → first 50 vehicles.

Inputs: account_id (required), page, page_size. Returns: result

search_incentivesA

Search incentives by vehicle make/model/year for a dealer account.

Use when: "what Honda Civic 2024 incentives are available for dealer 1042?" Example: account_id=1042, make="Honda", model="Civic", year=2024 → flat list of matching incentives.

Inputs: account_id (required), make, year, model. Returns: result

search_inventoryA

Search a dealer's inventory by make/model/year/price range.

Use when: "show me used Honda Civics under $25k at dealer 1042." Example: account_id=1042, make="Honda", model="Civic", max_price=25000 → flat list of matching vehicles.

Inputs: account_id (required), make, year, model, +2 more. Returns: result

update_vehicleA

Update one or more fields on an existing vehicle listing.

Use when: "drop the price on vehicle 9001 to $22,995" or "vehicle 9001 just got new photos — update the photoUrl". Example: vehicle_id=9001, price=22995, mileage=12550 → updated record. Common fields: price, mileage, description, photoUrl, status.

Inputs: fields (required), vehicle_id (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 14 tools

    Disambiguation5/5

    Each tool targets a distinct action (create, delete, get, update, list, iterate, search) on specific resources (vehicle, account, incentive, health). Even the paired list_/iter_ versions are clearly differentiated by pagination vs. flat array. No ambiguity.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun snake_case pattern. The outlier is health_check, which uses a noun_noun structure instead of a clear verb (e.g., check_health). Otherwise, naming is predictable and uniform.

    Tool Count5/5

    14 tools is well-scoped for a dealership management domain. Each tool serves a clear purpose without redundancy. The count is neither too sparse nor excessive.

    Completeness4/5

    Vehicles have full CRUD coverage (create, get, update, delete, list, iterate, search). Accounts and incentives are read-only (get, list, iterate/search) but that may be by design. Minor gap: no create/update/delete for accounts or incentives, but core workflows are covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Pipedrive API v2, enabling management of deals, persons, organizations, products, activities, and pipelines through natural language in MCP clients like Cursor and Claude Desktop.
      12 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the FieldRoutes pest-control / lawn-care operations platform — talk to your data from Claude, Cursor, or any MCP client.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for the Qualia title and escrow platform, enabling you to talk to your orders, messages, and documents from Claude, Cursor, or any MCP client.
      7
      2
      MIT