# Dealer Directory

> Full reference for the search_dealerships and search_dealers tools — find US and Canada dealerships and dealer groups by name, location or identifier, and connect them to inventory and sold-summary analysis.

Two tools search MarketCheck's dealer directory for the US and Canada. Use `search_dealerships` for new work — it is multi-rooftop and dealership-group aware. `search_dealers` is the legacy directory, kept for `dealer_id`-style records and the `listing_count_range` inventory-size filter.



## search_dealerships

| Property | Value    |
|----------|----------|
| Tool name | `search_dealerships` |
| Markets | US, Canada |
| Required | `country` |
| API endpoint | [`GET /v2/dealerships/car`](/docs/api/cars/dealerships/dealerships) |




### Key parameters

| Group      | Parameters |
|------------|------------|
| Location | `latitude` + `longitude` or `zip`, plus `radius` (miles, max 7000); `city`, `state`, `msa_code` |
| Identity | `inventory_url`, `mc_website_id`, `mc_dealer_id`, `mc_location_id`, `mc_rooftop_id` |
| Groups | `mc_dealership_group_id`, `mc_dealership_group_name`, `mc_sub_dealership_group_id`, `mc_sub_dealership_group_name` |
| Type | `dealer_type`, `mc_category` (Dealer, Retailer, Dealership Group, Aggregator, Marketing, Financing) |
| Output | `rows` (default 10, max 50), `start`, `sort_by`, `sort_order`, `facets`, `range_facets` |




### Using it with get_sold_summary

- **One dealer's sales:** pass the dealership's `inventory_url` as `source` in [`get_sold_summary`](/docs/get-started/api/mcp/tools/sold-summary). Several rooftops: a comma-separated list of `inventory_url`s.
- **A dealership group's sales:** pass `mc_dealership_group_name` as `dealership_group_name`.



### Example

```text
search_dealerships(
  country="us",
  city="Austin",
  state="TX",
  mc_dealership_group_name="Lithia Motors Inc."
)
```



## search_dealers (legacy)

| Property | Value    |
|----------|----------|
| Tool name | `search_dealers` |
| Markets | US, Canada |
| Required | `country` |
| API endpoint | [`GET /v2/dealers/car`](/docs/api/cars/dealerships/dealers-search) |


Takes the same location filters as `search_dealerships`, plus `dealer_type`, `inventory_url` and `listing_count_range`. It has no dealership-group fields.



## Use Cases

- "List Honda dealerships in Austin, TX."
- "Which rooftops belong to Lithia Motors in California?"
- "How many used cars did this dealer sell last month?" (`search_dealerships` → `get_sold_summary`)