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

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

Find cars by registration plate

search_uk_active_cars(
  vrm="AB12 CDE"
)

Low-emission vehicles in Scotland

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

Discover available makes and body types

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`

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

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

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

Vehicles with finance options that recently sold

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