cox-automotive-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cox-automotive-mcp List all vehicles under $25,000 in dealer 1042's inventory."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Verify |
| Paginated list of dealer accounts the API key can access. |
| Flat list of all accounts (auto-paginates). |
| One dealer account by id. |
| Paginated incentives (rebates, finance offers) for an account. |
| One incentive by id within an account. |
| Filter incentives by vehicle make/model/year. |
| Paginated vehicles in a dealer's inventory. |
| Flat list of all inventory vehicles (auto-paginates). |
| One vehicle listing by id. |
| Add a vehicle to inventory. |
| Update fields on a vehicle (price, mileage, photos, status). |
| Remove a vehicle from inventory. |
| Filter inventory by make/model/year/price range. |
Install
pip install cox-automotive-mcpOr 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_mcpAdd 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.AsyncClientwith connection pooling (100 max, 20 keepalive) + transport-level retriesTyped 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-AfterAuto-paginating iterators (
iter_accounts,iter_inventory,iter_incentives) that walk thepage/pageSizecursor without caller mathisError-compliance — every MCP tool raises on failure so FastMCP sets
isError: trueon 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_LOGfile) — SOC2 baseline for B2B procurementProperty-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-checkTest coverage is enforced at 80% via pytest --cov.
Related MCPs
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 toolscreate_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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for accessing Claude Code plugins. Enables retrieving plugin lists and detailed information via MCP clients like Claude Desktop, Cursor.2MIT
- AlicenseNot gradedqualityDmaintenanceMCP 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 npm2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the FieldRoutes pest-control / lawn-care operations platform — talk to your data from Claude, Cursor, or any MCP client.MIT
- AlicenseAqualityDmaintenanceMCP 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.72MIT