Tool reference

bluelink-mcp has 15 tools in 5 groups: 7 read, 7 write and 1 unlock.

Each tool is labelled with the setting it needs:

Label	Registered when
🟢 read	Always
🟠 write	BLUELINK_ALLOW_WRITES=true
🔴 unlock	BLUELINK_ALLOW_WRITES=true and BLUELINK_ALLOW_UNLOCK=true

Every tool takes an optional vehicle (name, VIN or ID), which you can leave out when the account has one car. Commands wait for the car to confirm by default (wait), which usually takes 20 to 60 seconds.

Contents

• status: The car’s state as Bluelink last heard it, live refreshes, location and command results.
• history: Driving history and daily energy use.
• climate: Pre-conditioning the cabin: temperature, defrost, heated rear window, steering wheel and seats.
• charging: Starting and stopping charging, and charge limits.
• security: Locks and hazard lights.

status

The car’s state as Bluelink last heard it, live refreshes, location and command results.

Tool	Access	Summary
list_vehicles	🟢 read	List vehicles
get_vehicle_status	🟢 read	Get vehicle status
refresh_vehicle_status	🟢 read	Refresh vehicle status from the car
get_vehicle_location	🟢 read	Get vehicle location
get_command_status	🟢 read	Get command status

list_vehicles

🟢 read

List the vehicles on the Bluelink account.

No arguments.

get_vehicle_status

🟢 read

Get the car’s last reported state: battery and fuel, range, charging, climate, locks, doors, windows, tyres, warnings and charging schedule. Does not wake the car.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.

refresh_vehicle_status

🟢 read

Wake the car and fetch live state, then return it like get_vehicle_status. Uses a little 12V battery and API quota, so it is rate limited.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.

get_vehicle_location

🟢 read

Get where the car is parked (latitude/longitude, and an address if geocoding is on).

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.

get_command_status

🟢 read

Check whether an earlier remote command succeeded (pending, success, failed, timeout).

Argument	Type	Required	Default	Description
action_id	string	yes		The action_id a command returned.
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.

history

Driving history and daily energy use.

Tool	Access	Summary
get_trips	🟢 read	Get trips
get_energy_usage	🟢 read	Get daily energy usage

get_trips

🟢 read

Get driving history: trips for a day, or a month’s summary with trip counts per day. Not every region supports this (Europe does).

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
date	string			YYYY-MM-DD for that day’s trips, or YYYY-MM for a month summary. Defaults to today.

get_energy_usage

🟢 read

Get daily electric energy use (Wh) split into driving, climate, electronics and battery care, plus regenerated energy and distance. EVs and PHEVs in some regions.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
days	integer		7	How many recent days.

climate

Pre-conditioning the cabin: temperature, defrost, heated rear window, steering wheel and seats.

Tool	Access	Summary
start_climate	🟠 write	Start climate control
stop_climate	🟠 write	Stop climate control

start_climate

🟠 write

Start pre-conditioning the cabin (heating or cooling). Seat settings only apply to cars that support them. On a plug-in hybrid this runs from the high-voltage battery.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
temperature	number		21	Target cabin temperature, 14-30 °C, in 0.5 steps.
duration_minutes	integer		10	How long to run.
defrost	boolean		false	Front windscreen defrost.
heated_rear_window_and_mirrors	boolean		false	Heat the rear window and door mirrors.
heated_steering_wheel	boolean		false	Heat the steering wheel.
front_left_seat	off | low_heat | medium_heat | high_heat | low_cool | medium_cool | high_cool			Seat heating or ventilation, on cars that have it. Leave out to keep it as is.
front_right_seat	off | low_heat | medium_heat | high_heat | low_cool | medium_cool | high_cool			Seat heating or ventilation, on cars that have it. Leave out to keep it as is.
rear_left_seat	off | low_heat | medium_heat | high_heat | low_cool | medium_cool | high_cool			Seat heating or ventilation, on cars that have it. Leave out to keep it as is.
rear_right_seat	off | low_heat | medium_heat | high_heat | low_cool | medium_cool | high_cool			Seat heating or ventilation, on cars that have it. Leave out to keep it as is.
wait	boolean		true	Wait (up to ~90 s) for the car to confirm the command.

stop_climate

🟠 write

Stop cabin pre-conditioning.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
wait	boolean		true	Wait (up to ~90 s) for the car to confirm the command.

charging

Starting and stopping charging, and charge limits.

Tool	Access	Summary
start_charging	🟠 write	Start charging
stop_charging	🟠 write	Stop charging
set_charge_limits	🟠 write	Set charge limits

start_charging

🟠 write

Start charging now (the car must be plugged in). Overrides a charging schedule.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
wait	boolean		true	Wait (up to ~90 s) for the car to confirm the command.

stop_charging

🟠 write

Stop charging.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
wait	boolean		true	Wait (up to ~90 s) for the car to confirm the command.

set_charge_limits

🟠 write

Set the maximum charge level. Mainly for EVs; many plug-in hybrids don’t support it.

Argument	Type	Required	Default	Description
ac_percent	integer	yes		Limit for AC (home/public) charging.
dc_percent	integer	yes		Limit for DC rapid charging.
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
wait	boolean		true	Wait (up to ~90 s) for the car to confirm the command.

security

Locks and hazard lights.

Tool	Access	Summary
lock_vehicle	🟠 write	Lock the car
unlock_vehicle	🔴 unlock	Unlock the car
flash_hazard_lights	🟠 write	Flash hazard lights

lock_vehicle

🟠 write

Lock the car’s doors.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
wait	boolean		true	Wait (up to ~90 s) for the car to confirm the command.

unlock_vehicle

🔴 unlock

Unlock the car’s doors. Only do this when the user clearly asks for it.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
wait	boolean		true	Wait (up to ~90 s) for the car to confirm the command.

flash_hazard_lights

🟠 write

Flash the hazard lights briefly, e.g. to find the car in a car park.

Argument	Type	Required	Default	Description
vehicle	string			Vehicle name, VIN or ID. Optional if the account has one vehicle.
wait	boolean		true	Wait (up to ~90 s) for the car to confirm the command.