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.

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.

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", ...}, ...].

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.

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.

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.

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.

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.

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": "...", ...}, ...].

Fetch one vehicle listing by id.

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

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.

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.

Remove a vehicle from inventory.

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

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.