# UK Tools

> Full reference for UK market tools — search_uk_active_cars and search_uk_recent_cars — with UK-specific filters including VRM lookup, ULEZ compliance, insurance groups, and write-off categories.

The MarketCheck MCP Server includes two dedicated UK market tools that support all the UK-specific data fields and filters not available in the US/Canada tools.



## search_uk_active_cars

Search for cars **currently listed for sale** in the United Kingdom.



### Overview

| Property | Value    |
|----------|----------|
| Tool name | `search_uk_active_cars` |
| Market | United Kingdom |
| Default rows | 10 (max 50) |
| API endpoint | `GET /v2/search/car/uk/active` |




### UK-Specific Parameters

These parameters are available **in addition** to the standard vehicle, pricing, color, timing, dealer, and analytics parameters shared with the US tools:

| Parameter   | Type        | Description |
|-------------|-------------|-------------|
| `vrm` | string | Vehicle Registration Mark (number plate) lookup |
| `vehicle_registration_mark` | string | Alias for `vrm` |
| `vehicle_registration_date_range` | string | Registration date range (`YYYYMMDD-YYYYMMDD`) |
| `postal_code` | string | UK postal code (e.g., `"SW1A 1AA"`) |
| `county` | string | UK county name |
| `country` | string | Country sub-region: `"uk"`, `"england"`, `"scotland"`, `"northern ireland"`, `"wales"` |
| `insurance_group` | string | UK insurance group filter |
| `num_owners` | string | Number of previous owners |
| `fca_status` | string | FCA authorization status |
| `write_off_category` | string | Write-off category filter |
| `exclude_write_off_category` | string | Exclude specific write-off categories |
| `ulez_compliant` | string | ULEZ (Ultra Low Emission Zone) compliant filter |
| `co2_emissions` | string | CO2 emissions filter |
| `combined_mpg_range` | string | Combined fuel economy range |
| `performance_co2_range` | string | Performance CO2 range |




### EV-Specific Parameters (UK)

| Parameter   | Type        | Description |
|-------------|-------------|-------------|
| `ev_battery_type` | string | Battery type filter |
| `ev_battery_capacity_range` | string | Battery capacity range |
| `ev_vehicle_range` | string | Electric vehicle range filter |




### UK Build Object

When `include_build_object=true`, the UK build object includes additional fields beyond the US version:

- `combined_mpg` — Combined fuel economy
- `performance_torque_ftlb`, `performance_torque_nm` — Torque specs
- `performance_maxspeed_mph` — Maximum speed
- `performance_power_bhp`, `performance_power_kw` — Power output
- `performance_co2` — CO2 emissions
- `euro_status` — Euro emissions standard
- `wheelbase_category` — Wheelbase classification



### Use Cases



#### Search for electric vehicles in London

```text
search_uk_active_cars(
  city="London",
  fuel_type="Electric",
  ulez_compliant="true",
  rows=10
)
```



#### Find cars by registration plate

```text
search_uk_active_cars(
  vrm="AB12 CDE"
)
```



#### Low-emission vehicles in Scotland

```text
search_uk_active_cars(
  country="scotland",
  co2_emissions="0-100",
  rows=10
)
```



#### Discover available makes and body types

```text
search_uk_active_cars(
  facets="make,body_type,fuel_type",
  rows=1
)
```

---



## search_uk_recent_cars

Search **expired and sold** UK listings from the last 90 days. Designed for historical market analysis in the UK.



### Overview

| Property | Value    |
|----------|----------|
| Tool name | `search_uk_recent_cars` |
| Market | United Kingdom |
| Data | Expired/sold listings from last 90 days |
| Default rows | 10 (max 50) |
| API endpoint | `GET /v2/search/car/uk/recents` |


> **IMPORTANT**: 
> This tool returns only expired/sold UK listings. For active UK inventory, use `search_uk_active_cars` above.



### Additional Parameters (beyond UK active search)

| Parameter   | Type        | Description |
|-------------|-------------|-------------|
| `sold` | bool | Filter to confirmed sold listings |
| `expired` | bool | Filter by expiry status |
| `dealer_name` | string | Filter by dealer name |
| `dealership_group_name` | string | Filter by dealership group |
| `car_include_lease` | bool | Include listings with lease options |
| `car_include_finance` | bool | Include listings with finance options |
| `lease_term` | int | Filter by lease term |
| `finance_loan_term` | int | Filter by finance loan term |
| `finance_emp` | int | Filter by finance estimated monthly payment |


All UK-specific parameters from `search_uk_active_cars` are also supported.



### Use Cases



#### Recently sold BMWs in England

```text
search_uk_recent_cars(
  country="england",
  make="BMW",
  sold=true,
  rows=20,
  sort_by="last_seen",
  sort_order="desc"
)
```



#### Sales trends by body type in the UK

```text
search_uk_recent_cars(
  country="uk",
  facets="body_type|0|30",
  sold=true,
  rows=1
)
```



#### Vehicles with finance options that recently sold

```text
search_uk_recent_cars(
  country="uk",
  car_include_finance=true,
  sold=true,
  rows=20
)
```



## See Also

- [Search Active Cars](/docs/get-started/api/mcp/tools/search-active-cars) — US/Canada active inventory
- [Search Past 90 Days](/docs/get-started/api/mcp/tools/search-past-90-days) — US/Canada historical data
- [Workflows & Use Cases](/docs/get-started/api/mcp/workflows) — UK research patterns