TuneWorks is an MCP server published by io.github.chrismore, hosted at tuneworks.ai. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 102 tools, including calculate_race_fuel_and_weight, calculate_gear_ratio_speed, calculate_tire_pressure_adjustment, calculate_corner_balance, calculate_spring_wheel_rate.
Motorsports workspace for vehicles, setups, sessions, logs, maintenance, and race engineering.
1,094 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Plan a race fuel load, reserve, start weight, and projected minimum-weight margin. Calculates from measured inputs without authentication and does not read or save account data. Assumes the entered per-lap consumption applies to race, formation, and allowance laps. Finish weight retains only the selected reserve. Confirm your series weighing rules and validate consumption with real data.
| Parameter | Type | Description |
|---|---|---|
| fuel * | string | Fuel type |
| ballast * | number | Ballast fitted (lb in US; kg in metric) |
| lapTime | number | Expected lap time (sec) |
| reserve * | number | Fuel reserve (%) |
| duration |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| number |
| Race duration (min) |
| raceLaps | number | Scheduled race laps (laps) |
| raceMode * | string | Race format |
| extraLaps * | number | Extra-lap allowance (laps) |
| baseWeight * | number | Car + driver without fuel (lb in US; kg in metric) |
| unitSystem * | string | Units for all inputs and results, as specified on each field. |
| consumption * | number | Fuel consumption per lap (gal in US; L in metric) |
| customDensity | number | Custom fuel density (lb/gal in US; kg/L in metric) |
| formationLaps * | number | Formation / warm-up laps (laps) |
| minimumWeight * | number | Class minimum weight (lb in US; kg in metric) |
{
"name": "calculate_race_fuel_and_weight",
"title": "Race Fuel and Minimum Weight Calculator",
"description": "Plan a race fuel load, reserve, start weight, and projected minimum-weight margin. Calculates from measured inputs without authentication and does not read or save account data. Assumes the entered per-lap consumption applies to race, formation, and allowance laps. Finish weight retains only the selected reserve. Confirm your series weighing rules and validate consumption with real data.",
"inputSchema": {
"type": "object",
"required": [
"consumption",
"formationLaps",
"extraLaps",
"reserve",
"baseWeight",
"minimumWeight",
"ballast",
"raceMode",
"fuel",
"unitSystem"
],
"properties": {
"fuel": {
"enum": [
"gas",
"race",
"e85",
"custom"
],
"type": "string",
"description": "Fuel type"
},
"ballast": {
"type": "number",
"minimum": 0,
"description": "Ballast fitted (lb in US; kg in metric)"
},
"lapTime": {
"type": "number",
"description": "Expected lap time (sec)",
"exclusiveMinimum": 0
},
"reserve": {
"type": "number",
"minimum": 0,
"description": "Fuel reserve (%)"
},
"duration": {
"type": "number",
"description": "Race duration (min)",
"exclusiveMinimum": 0
},
"raceLaps": {
"type": "number",
"description": "Scheduled race laps (laps)",
"exclusiveMinimum": 0
},
"raceMode": {
"enum": [
"timed",
"laps"
],
"type": "string",
"description": "Race format"
},
"extraLaps": {
"type": "number",
"minimum": 0,
"description": "Extra-lap allowance (laps)"
},
"baseWeight": {
"type": "number",
"description": "Car + driver without fuel (lb in US; kg in metric)",
"exclusiveMinimum": 0
},
"unitSystem": {
"enum": [
"us",
"metric"
],
"type": "string",
"description": "Units for all inputs and results, as specified on each field."
},
"consumption": {
"type": "number",
"description": "Fuel consumption per lap (gal in US; L in metric)",
"exclusiveMinimum": 0
},
"customDensity": {
"type": "number",
"description": "Custom fuel density (lb/gal in US; kg/L in metric)",
"exclusiveMinimum": 0
},
"formationLaps": {
"type": "number",
"minimum": 0,
"description": "Formation / warm-up laps (laps)"
},
"minimumWeight": {
"type": "number",
"description": "Class minimum weight (lb in US; kg in metric)",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Race Fuel and Minimum Weight Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Check speed, RPM, and shift drop from tire size, final drive, and gear ratio. Calculates from measured inputs without authentication and does not read or save account data. Use measured tire diameter when possible. Tire growth and converter/clutch slip can move real-world numbers.
| Parameter | Type | Description |
|---|---|---|
| rpm * | number | Engine RPM (rpm) |
| gear * | number | Gear ratio |
| mode * | string | Primary answer |
| speed * | number | Vehicle speed (mph in imperial; km/h in metric) |
| nextGear * | number | Next gear ratio |
| finalDrive * | number | Final drive |
| unitSystem * | string | Units for all inputs and results, as specified on each field. |
| tireDiameter * | number | Tire diameter (in in imperial; mm in metric) |
{
"name": "calculate_gear_ratio_speed",
"title": "Gear Ratio Speed Calculator",
"description": "Check speed, RPM, and shift drop from tire size, final drive, and gear ratio. Calculates from measured inputs without authentication and does not read or save account data. Use measured tire diameter when possible. Tire growth and converter/clutch slip can move real-world numbers.",
"inputSchema": {
"type": "object",
"required": [
"rpm",
"speed",
"gear",
"finalDrive",
"tireDiameter",
"nextGear",
"mode",
"unitSystem"
],
"properties": {
"rpm": {
"type": "number",
"minimum": 0,
"description": "Engine RPM (rpm)"
},
"gear": {
"type": "number",
"description": "Gear ratio",
"exclusiveMinimum": 0
},
"mode": {
"enum": [
"speed",
"rpm"
],
"type": "string",
"description": "Primary answer"
},
"speed": {
"type": "number",
"minimum": 0,
"description": "Vehicle speed (mph in imperial; km/h in metric)"
},
"nextGear": {
"type": "number",
"description": "Next gear ratio",
"exclusiveMinimum": 0
},
"finalDrive": {
"type": "number",
"description": "Final drive",
"exclusiveMinimum": 0
},
"unitSystem": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "Units for all inputs and results, as specified on each field."
},
"tireDiameter": {
"type": "number",
"description": "Tire diameter (in in imperial; mm in metric)",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Gear Ratio Speed Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Turn cold, hot, and target hot pressures into the next cold pressure to try. Calculates from measured inputs without authentication and does not read or save account data. This gives a next-test pressure, not a universal ideal. Recheck after the next run.
| Parameter | Type | Description |
|---|---|---|
| hot * | number | Measured hot pressure (psi in imperial; bar in metric) |
| cold * | number | Starting cold pressure (psi in imperial; bar in metric) |
| target * | number | Target hot pressure (psi in imperial; bar in metric) |
| unitSystem * | string | Units for all inputs and results, as specified on each field. |
| ambientChange * | number | Expected ambient temp change (F in imperial; C in metric) |
{
"name": "calculate_tire_pressure_adjustment",
"title": "Tire Pressure Adjustment Calculator",
"description": "Turn cold, hot, and target hot pressures into the next cold pressure to try. Calculates from measured inputs without authentication and does not read or save account data. This gives a next-test pressure, not a universal ideal. Recheck after the next run.",
"inputSchema": {
"type": "object",
"required": [
"cold",
"hot",
"target",
"ambientChange",
"unitSystem"
],
"properties": {
"hot": {
"type": "number",
"description": "Measured hot pressure (psi in imperial; bar in metric)",
"exclusiveMinimum": 0
},
"cold": {
"type": "number",
"description": "Starting cold pressure (psi in imperial; bar in metric)",
"exclusiveMinimum": 0
},
"target": {
"type": "number",
"description": "Target hot pressure (psi in imperial; bar in metric)",
"exclusiveMinimum": 0
},
"unitSystem": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "Units for all inputs and results, as specified on each field."
},
"ambientChange": {
"type": "number",
"description": "Expected ambient temp change (F in imperial; C in metric)"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Tire Pressure Adjustment Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Calculate cross weight, left/right balance, and front/rear split from four scale pads. Calculates from measured inputs without authentication and does not read or save account data. Measure the car in the same state you drive it: driver, fuel, ballast, and tire pressures matter.
| Parameter | Type | Description |
|---|---|---|
| lf * | number | Left front (lb in imperial; kg in metric) |
| lr * | number | Left rear (lb in imperial; kg in metric) |
| rf * | number | Right front (lb in imperial; kg in metric) |
| rr * | number | Right rear (lb in imperial; kg in metric) |
| unitSystem * | string | Units for all inputs and results, as specified on each field. |
{
"name": "calculate_corner_balance",
"title": "Corner Balance Calculator",
"description": "Calculate cross weight, left/right balance, and front/rear split from four scale pads. Calculates from measured inputs without authentication and does not read or save account data. Measure the car in the same state you drive it: driver, fuel, ballast, and tire pressures matter.",
"inputSchema": {
"type": "object",
"required": [
"lf",
"rf",
"lr",
"rr",
"unitSystem"
],
"properties": {
"lf": {
"type": "number",
"description": "Left front (lb in imperial; kg in metric)",
"exclusiveMinimum": 0
},
"lr": {
"type": "number",
"description": "Left rear (lb in imperial; kg in metric)",
"exclusiveMinimum": 0
},
"rf": {
"type": "number",
"description": "Right front (lb in imperial; kg in metric)",
"exclusiveMinimum": 0
},
"rr": {
"type": "number",
"description": "Right rear (lb in imperial; kg in metric)",
"exclusiveMinimum": 0
},
"unitSystem": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "Units for all inputs and results, as specified on each field."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Corner Balance Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Convert spring rate and motion ratio into wheel rate for setup comparisons. Calculates from measured inputs without authentication and does not read or save account data. Wheel rate compares spring changes. It does not account for bars, bump stops, tires, or aero load.
| Parameter | Type | Description |
|---|---|---|
| springRate * | number | Spring rate (lb/in in imperial; N/mm in metric) |
| unitSystem * | string | Units for all inputs and results, as specified on each field. |
| motionRatio * | number | Motion ratio |
| springAngle * | number | Spring angle from vertical (deg) |
| cornerWeight * | number | Corner weight (lb in imperial; kg in metric) |
{
"name": "calculate_spring_wheel_rate",
"title": "Spring Rate Wheel Rate Calculator",
"description": "Convert spring rate and motion ratio into wheel rate for setup comparisons. Calculates from measured inputs without authentication and does not read or save account data. Wheel rate compares spring changes. It does not account for bars, bump stops, tires, or aero load.",
"inputSchema": {
"type": "object",
"required": [
"springRate",
"motionRatio",
"springAngle",
"cornerWeight",
"unitSystem"
],
"properties": {
"springRate": {
"type": "number",
"description": "Spring rate (lb/in in imperial; N/mm in metric)",
"exclusiveMinimum": 0
},
"unitSystem": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "Units for all inputs and results, as specified on each field."
},
"motionRatio": {
"type": "number",
"description": "Motion ratio",
"exclusiveMinimum": 0
},
"springAngle": {
"type": "number",
"minimum": 0,
"description": "Spring angle from vertical (deg)",
"exclusiveMaximum": 90
},
"cornerWeight": {
"type": "number",
"description": "Corner weight (lb in imperial; kg in metric)",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Spring Rate Wheel Rate Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Estimate injector size from horsepower, fuel type, injector count, and duty cycle. Calculates from measured inputs without authentication and does not read or save account data. This is a sizing estimate. Confirm with your tuner and fuel pressure data.
| Parameter | Type | Description |
|---|---|---|
| hp * | number | Horsepower target (hp) |
| duty * | number | Target duty cycle (%) |
| fuel * | string | Fuel type |
| current * | number | Current injector size (cc/min) |
| injectors * | integer | Injector count |
{
"name": "calculate_fuel_injector_size",
"title": "Fuel Injector Duty Cycle Calculator",
"description": "Estimate injector size from horsepower, fuel type, injector count, and duty cycle. Calculates from measured inputs without authentication and does not read or save account data. This is a sizing estimate. Confirm with your tuner and fuel pressure data.",
"inputSchema": {
"type": "object",
"required": [
"hp",
"injectors",
"duty",
"current",
"fuel"
],
"properties": {
"hp": {
"type": "number",
"description": "Horsepower target (hp)",
"exclusiveMinimum": 0
},
"duty": {
"type": "number",
"maximum": 100,
"description": "Target duty cycle (%)",
"exclusiveMinimum": 0
},
"fuel": {
"enum": [
"gas",
"e85",
"methanol"
],
"type": "string",
"description": "Fuel type"
},
"current": {
"type": "number",
"description": "Current injector size (cc/min)",
"exclusiveMinimum": 0
},
"injectors": {
"type": "integer",
"description": "Injector count",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Fuel Injector Duty Cycle Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Convert AFR and lambda across gasoline, E85, methanol, and race fuel scales. Calculates from measured inputs without authentication and does not read or save account data. Use this as a conversion reference. Tune targets depend on fuel, engine, load, and calibration strategy.
| Parameter | Type | Description |
|---|---|---|
| afr * | number | AFR |
| fuel * | string | Fuel scale |
| lambda * | number | Lambda |
{
"name": "convert_afr_lambda",
"title": "AFR Lambda Converter",
"description": "Convert AFR and lambda across gasoline, E85, methanol, and race fuel scales. Calculates from measured inputs without authentication and does not read or save account data. Use this as a conversion reference. Tune targets depend on fuel, engine, load, and calibration strategy.",
"inputSchema": {
"type": "object",
"required": [
"afr",
"lambda",
"fuel"
],
"properties": {
"afr": {
"type": "number",
"description": "AFR",
"exclusiveMinimum": 0
},
"fuel": {
"enum": [
"gas",
"e85",
"methanol",
"race"
],
"type": "string",
"description": "Fuel scale"
},
"lambda": {
"type": "number",
"description": "Lambda",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "AFR Lambda Converter",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Estimate front brake bias from piston area, rotor size, and pad friction. Calculates from measured inputs without authentication and does not read or save account data. This estimates mechanical bias. Tire grip, weight transfer, ABS, and balance bars still matter.
| Parameter | Type | Description |
|---|---|---|
| rearMu * | number | Rear pad friction |
| frontMu * | number | Front pad friction |
| rearRotor * | number | Rear effective radius (in in imperial; mm in metric) |
| frontRotor * | number | Front effective radius (in in imperial; mm in metric) |
| rearPiston * | number | Rear total piston area (in2 in imperial; cm2 in metric) |
| unitSystem * | string | Units for all inputs and results, as specified on each field. |
| frontPiston * | number | Front total piston area (in2 in imperial; cm2 in metric) |
{
"name": "calculate_brake_bias",
"title": "Brake Bias Calculator",
"description": "Estimate front brake bias from piston area, rotor size, and pad friction. Calculates from measured inputs without authentication and does not read or save account data. This estimates mechanical bias. Tire grip, weight transfer, ABS, and balance bars still matter.",
"inputSchema": {
"type": "object",
"required": [
"frontPiston",
"rearPiston",
"frontRotor",
"rearRotor",
"frontMu",
"rearMu",
"unitSystem"
],
"properties": {
"rearMu": {
"type": "number",
"description": "Rear pad friction",
"exclusiveMinimum": 0
},
"frontMu": {
"type": "number",
"description": "Front pad friction",
"exclusiveMinimum": 0
},
"rearRotor": {
"type": "number",
"description": "Rear effective radius (in in imperial; mm in metric)",
"exclusiveMinimum": 0
},
"frontRotor": {
"type": "number",
"description": "Front effective radius (in in imperial; mm in metric)",
"exclusiveMinimum": 0
},
"rearPiston": {
"type": "number",
"description": "Rear total piston area (in2 in imperial; cm2 in metric)",
"exclusiveMinimum": 0
},
"unitSystem": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "Units for all inputs and results, as specified on each field."
},
"frontPiston": {
"type": "number",
"description": "Front total piston area (in2 in imperial; cm2 in metric)",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Brake Bias Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Compare tire diameter, circumference, ride height, and speedometer change. Calculates from measured inputs without authentication and does not read or save account data. Actual mounted diameter changes by tire model and pressure. Use manufacturer specs when available.
| Parameter | Type | Description |
|---|---|---|
| newWheel * | number | New wheel diameter (in in imperial; mm in metric) |
| newWidth * | number | New width (mm) |
| oldWheel * | number | Current wheel diameter (in in imperial; mm in metric) |
| oldWidth * | number | Current width (mm) |
| newAspect * | number | New aspect ratio (%) |
| oldAspect * | number | Current aspect ratio (%) |
| unitSystem * | string | Units for all inputs and results, as specified on each field. |
{
"name": "compare_tire_sizes",
"title": "Tire Size Comparison Calculator",
"description": "Compare tire diameter, circumference, ride height, and speedometer change. Calculates from measured inputs without authentication and does not read or save account data. Actual mounted diameter changes by tire model and pressure. Use manufacturer specs when available.",
"inputSchema": {
"type": "object",
"required": [
"oldWidth",
"oldAspect",
"oldWheel",
"newWidth",
"newAspect",
"newWheel",
"unitSystem"
],
"properties": {
"newWheel": {
"type": "number",
"description": "New wheel diameter (in in imperial; mm in metric)",
"exclusiveMinimum": 0
},
"newWidth": {
"type": "number",
"description": "New width (mm)",
"exclusiveMinimum": 0
},
"oldWheel": {
"type": "number",
"description": "Current wheel diameter (in in imperial; mm in metric)",
"exclusiveMinimum": 0
},
"oldWidth": {
"type": "number",
"description": "Current width (mm)",
"exclusiveMinimum": 0
},
"newAspect": {
"type": "number",
"maximum": 100,
"description": "New aspect ratio (%)",
"exclusiveMinimum": 0
},
"oldAspect": {
"type": "number",
"maximum": 100,
"description": "Current aspect ratio (%)",
"exclusiveMinimum": 0
},
"unitSystem": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "Units for all inputs and results, as specified on each field."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Tire Size Comparison Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Check camber and total toe against broad autocross and track baseline ranges. Calculates from measured inputs without authentication and does not read or save account data. This is a baseline checker, not a vehicle-specific prescription. Tire wear and driver feedback decide the next step.
| Parameter | Type | Description |
|---|---|---|
| use * | string | Use case |
| rearToe * | number | Rear total toe (in in imperial; mm in metric) |
| frontToe * | number | Front total toe (in in imperial; mm in metric) |
| rearCamber * | number | Rear camber (deg) |
| unitSystem * | string | Units for all inputs and results, as specified on each field. |
| frontCamber * | number | Front camber (deg) |
{
"name": "check_race_alignment",
"title": "Race Alignment Checker",
"description": "Check camber and total toe against broad autocross and track baseline ranges. Calculates from measured inputs without authentication and does not read or save account data. This is a baseline checker, not a vehicle-specific prescription. Tire wear and driver feedback decide the next step.",
"inputSchema": {
"type": "object",
"required": [
"frontCamber",
"rearCamber",
"frontToe",
"rearToe",
"use",
"unitSystem"
],
"properties": {
"use": {
"enum": [
"hpde",
"autocross",
"street"
],
"type": "string",
"description": "Use case"
},
"rearToe": {
"type": "number",
"description": "Rear total toe (in in imperial; mm in metric)"
},
"frontToe": {
"type": "number",
"description": "Front total toe (in in imperial; mm in metric)"
},
"rearCamber": {
"type": "number",
"description": "Rear camber (deg)"
},
"unitSystem": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "Units for all inputs and results, as specified on each field."
},
"frontCamber": {
"type": "number",
"description": "Front camber (deg)"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Race Alignment Checker",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Compare two laps or sector sets and see the best theoretical lap. Calculates from measured inputs without authentication and does not read or save account data. Use sectors from timing, video, or data logs. Compare similar conditions before blaming setup.
| Parameter | Type | Description |
|---|---|---|
| newS1 * | number | New sector 1 (sec) |
| newS2 * | number | New sector 2 (sec) |
| newS3 * | number | New sector 3 (sec) |
| baselineS1 * | number | Baseline sector 1 (sec) |
| baselineS2 * | number | Baseline sector 2 (sec) |
| baselineS3 * | number | Baseline sector 3 (sec) |
{
"name": "calculate_lap_time_delta",
"title": "Lap Time Delta Calculator",
"description": "Compare two laps or sector sets and see the best theoretical lap. Calculates from measured inputs without authentication and does not read or save account data. Use sectors from timing, video, or data logs. Compare similar conditions before blaming setup.",
"inputSchema": {
"type": "object",
"required": [
"baselineS1",
"baselineS2",
"baselineS3",
"newS1",
"newS2",
"newS3"
],
"properties": {
"newS1": {
"type": "number",
"description": "New sector 1 (sec)",
"exclusiveMinimum": 0
},
"newS2": {
"type": "number",
"description": "New sector 2 (sec)",
"exclusiveMinimum": 0
},
"newS3": {
"type": "number",
"description": "New sector 3 (sec)",
"exclusiveMinimum": 0
},
"baselineS1": {
"type": "number",
"description": "Baseline sector 1 (sec)",
"exclusiveMinimum": 0
},
"baselineS2": {
"type": "number",
"description": "Baseline sector 2 (sec)",
"exclusiveMinimum": 0
},
"baselineS3": {
"type": "number",
"description": "Baseline sector 3 (sec)",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "Lap Time Delta Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Calculates an ethanol blend for a fresh tank, existing fuel, correction, or ratio without authentication or account-data access. Percentages are 0–100 and all volumes use the selected unit. Source ethanol contents are measured values. Fresh mode requires finalVolume; existing mode requires finalVolume, currentVolume, and currentEthanol; correction mode requires tankCapacity, currentVolume, and currentEthanol; ratio mode requires no volumes.
| Parameter | Type | Description |
|---|---|---|
| mode * | string | one of ["fresh","existing","correct","ratio"] |
| volumeUnit * | string | one of ["liters","us_gallons"] |
| finalVolume | number | Volume in volumeUnit. |
| tankCapacity | number | Volume in volumeUnit. |
| currentVolume | number | Volume in volumeUnit. |
| targetEthanol * | number | Ethanol percentage (0–100). |
| currentEthanol | number | Ethanol percentage (0–100). |
| pumpGasEthanol * | number | Ethanol percentage (0–100). |
| highFuelEthanol * | number | Ethanol percentage (0–100). |
{
"name": "calculate_ethanol_blend",
"title": "E85 Ethanol Blend Calculator",
"description": "Calculates an ethanol blend for a fresh tank, existing fuel, correction, or ratio without authentication or account-data access. Percentages are 0–100 and all volumes use the selected unit. Source ethanol contents are measured values. Fresh mode requires finalVolume; existing mode requires finalVolume, currentVolume, and currentEthanol; correction mode requires tankCapacity, currentVolume, and currentEthanol; ratio mode requires no volumes.",
"inputSchema": {
"type": "object",
"required": [
"mode",
"volumeUnit",
"targetEthanol",
"highFuelEthanol",
"pumpGasEthanol"
],
"properties": {
"mode": {
"enum": [
"fresh",
"existing",
"correct",
"ratio"
],
"type": "string"
},
"volumeUnit": {
"enum": [
"liters",
"us_gallons"
],
"type": "string"
},
"finalVolume": {
"type": "number",
"description": "Volume in volumeUnit.",
"exclusiveMinimum": 0
},
"tankCapacity": {
"type": "number",
"description": "Volume in volumeUnit.",
"exclusiveMinimum": 0
},
"currentVolume": {
"type": "number",
"description": "Volume in volumeUnit.",
"exclusiveMinimum": 0
},
"targetEthanol": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Ethanol percentage (0–100)."
},
"currentEthanol": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Ethanol percentage (0–100)."
},
"pumpGasEthanol": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Ethanol percentage (0–100)."
},
"highFuelEthanol": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Ethanol percentage (0–100)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"inputs": {
"type": "object"
},
"result": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"results": {
"type": "array",
"items": {
"type": "object"
}
},
"unitSystem": {
"type": "string"
},
"volumeUnit": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public calculator result with explicit units, website-equivalent results, or actionable invalid_input message.",
"additionalProperties": true
},
"annotations": {
"title": "E85 Ethanol Blend Calculator",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns the canonical TuneWorks website destination for an intentionally website-only AI, file-transfer, visualization, account, installation, invitation, or billing workflow.
No parameters.
{
"name": "get_tuneworks_website_handoff",
"title": "Get TuneWorks website handoff",
"description": "Returns the canonical TuneWorks website destination for an intentionally website-only AI, file-transfer, visualization, account, installation, invitation, or billing workflow.",
"inputSchema": {
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"capability"
],
"properties": {
"capability": {
"enum": [
"ai_copilot",
"telemetry_upload",
"haltech_ecu_recovery",
"log_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"capability"
],
"properties": {
"vehicleId": {
"type": "string",
"pattern": "\\S",
"maxLength": 128,
"minLength": 1
},
"capability": {
"type": "string",
"const": "ai_race_engineer"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"capability"
],
"properties": {
"logId": {
"type": "string",
"pattern": "\\S",
"maxLength": 128,
"minLength": 1
},
"capability": {
"type": "string",
"const": "ai_log_analyzer"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"capability"
],
"properties": {
"logId": {
"type": "string",
"pattern": "\\S",
"maxLength": 128,
"minLength": 1
},
"capability": {
"type": "string",
"const": "interactive_log_analysis"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"capability"
],
"properties": {
"setupId": {
"type": "string",
"pattern": "\\S",
"maxLength": 128,
"minLength": 1
},
"capability": {
"type": "string",
"const": "setup_comparison"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"capability",
"objectType",
"objectId"
],
"properties": {
"objectId": {
"type": "string",
"pattern": "\\S",
"maxLength": 128,
"minLength": 1
},
"capability": {
"type": "string",
"const": "object_file_upload"
},
"objectType": {
"enum": [
"vehicle",
"log",
"setup",
"session"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"capability"
],
"properties": {
"capability": {
"type": "string",
"const": "team_invitation"
},
"inviteToken": {
"type": "string",
"pattern": "\\S",
"maxLength": 512,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"capability",
"explicitUserRequest"
],
"properties": {
"capability": {
"type": "string",
"const": "billing_management"
},
"explicitUserRequest": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
}
],
"properties": {}
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool",
"websiteHandoff"
],
"properties": {
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Canonical TuneWorks website destination for an intentionally website-only workflow.",
"additionalProperties": true
},
"annotations": {
"title": "Get TuneWorks website handoff",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Provides understeer/oversteer setup guidance without authentication or access to TuneWorks account data.
| Parameter | Type | Description |
|---|---|---|
| notes | string | Optional driver feedback or setup context. |
| phase * | string | one of ["entry","middle","exit"] |
| speed | string | Optional speed range or driver note. |
| balance * | string | one of ["understeer","oversteer"] |
{
"name": "diagnose_handling_issue",
"title": "Diagnose handling issue",
"description": "Provides understeer/oversteer setup guidance without authentication or access to TuneWorks account data.",
"inputSchema": {
"type": "object",
"required": [
"balance",
"phase"
],
"properties": {
"notes": {
"type": "string",
"description": "Optional driver feedback or setup context."
},
"phase": {
"enum": [
"entry",
"middle",
"exit"
],
"type": "string"
},
"speed": {
"type": "string",
"description": "Optional speed range or driver note."
},
"balance": {
"enum": [
"understeer",
"oversteer"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"nextStep": {
"type": "string"
},
"diagnosis": {
"type": "object",
"description": "Balance, phase, summary, and recommended setup actions."
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"acquisitionScope": {
"type": "string"
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean"
}
},
"description": "Handling diagnosis result with bounded setup recommendations and a TuneWorks URL.",
"additionalProperties": true
},
"annotations": {
"title": "Diagnose handling issue",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Interprets inside, middle, and outside tire temperature readings without authentication or access to TuneWorks account data.
| Parameter | Type | Description |
|---|---|---|
| unit | string | one of ["f","c"] |
| readings * | object | Tire readings keyed by lf/rf/lr/rr, each with inside, middle, and outside numbers. |
| targetTemp | number | |
| tempWindow | number | |
| rearCamberSpread | number | |
| frontCamberSpread | number |
{
"name": "analyze_tire_temperatures",
"title": "Analyze tire temperatures",
"description": "Interprets inside, middle, and outside tire temperature readings without authentication or access to TuneWorks account data.",
"inputSchema": {
"type": "object",
"required": [
"readings"
],
"properties": {
"unit": {
"enum": [
"f",
"c"
],
"type": "string",
"default": "f"
},
"readings": {
"type": "object",
"description": "Tire readings keyed by lf/rf/lr/rr, each with inside, middle, and outside numbers."
},
"targetTemp": {
"type": "number",
"default": 180
},
"tempWindow": {
"type": "number",
"default": 10
},
"rearCamberSpread": {
"type": "number",
"default": 8
},
"frontCamberSpread": {
"type": "number",
"default": 12
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"unit": {
"type": "string"
},
"tires": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"balance": {
"type": "string"
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"nextTest": {
"type": "string"
},
"rearAverage": {
"type": "number"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"frontAverage": {
"type": "number"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"acquisitionScope": {
"type": "string"
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean"
}
},
"description": "Tire temperature analysis result with tire summaries, pressure/camber signals, and next test guidance.",
"additionalProperties": true
},
"annotations": {
"title": "Analyze tire temperatures",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Provides a bounded shock/damper adjustment recommendation without authentication or access to TuneWorks account data.
| Parameter | Type | Description |
|---|---|---|
| axle | string | one of ["front","rear","both"] |
| phase * | string | one of ["entry","middle","exit","transition","bumps"] |
| symptom * | string | one of ["understeer","oversteer","lazy","skips","bounces","bottoms"] |
| severity | number |
{
"name": "recommend_autocross_damper_adjustment",
"title": "Recommend autocross damper adjustment",
"description": "Provides a bounded shock/damper adjustment recommendation without authentication or access to TuneWorks account data.",
"inputSchema": {
"type": "object",
"required": [
"phase",
"symptom"
],
"properties": {
"axle": {
"enum": [
"front",
"rear",
"both"
],
"type": "string",
"default": "both"
},
"phase": {
"enum": [
"entry",
"middle",
"exit",
"transition",
"bumps"
],
"type": "string"
},
"symptom": {
"enum": [
"understeer",
"oversteer",
"lazy",
"skips",
"bounces",
"bottoms"
],
"type": "string"
},
"severity": {
"type": "number",
"default": 3,
"maximum": 5,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"nextStep": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"recommendation": {
"type": "object",
"description": "Recommended damper corner, adjustment direction, click count, reason, and validation check."
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"acquisitionScope": {
"type": "string"
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"authenticationRequired": {
"type": "boolean"
}
},
"description": "Autocross damper recommendation result with the adjustment corner, direction, click count, and check step.",
"additionalProperties": true
},
"annotations": {
"title": "Recommend autocross damper adjustment",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Search the public TuneWorks Autocross Site Finder by coordinates and minimum paved-area dimensions. This may take several minutes because it queries live map and imagery providers.
| Parameter | Type | Description |
|---|---|---|
| latitude * | number | |
| longitude * | number | |
| radiusMiles * | number | |
| minimumReviewScore | number | |
| minimumWidthMeters * | number | |
| minimumLengthMeters * | number |
{
"name": "find_autocross_sites",
"title": "Find autocross sites",
"description": "Search the public TuneWorks Autocross Site Finder by coordinates and minimum paved-area dimensions. This may take several minutes because it queries live map and imagery providers.",
"inputSchema": {
"type": "object",
"required": [
"latitude",
"longitude",
"radiusMiles",
"minimumWidthMeters",
"minimumLengthMeters"
],
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"radiusMiles": {
"type": "number",
"maximum": 30,
"minimum": 1
},
"minimumReviewScore": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"minimumWidthMeters": {
"type": "number",
"minimum": 1
},
"minimumLengthMeters": {
"type": "number",
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"warning": {
"type": "string"
},
"candidates": {
"type": "array",
"items": {
"type": "object"
}
},
"resultNote": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"acquisitionScope": {
"type": "string"
},
"garageContinuation": {
"type": "object",
"required": [
"goal",
"optional",
"requiresAuthentication",
"nextTool",
"message"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"message": {
"type": "string"
},
"nextTool": {
"type": "string",
"const": "get_garage_summary"
},
"optional": {
"type": "boolean",
"const": true
},
"requiresAuthentication": {
"type": "boolean"
}
},
"additionalProperties": false
},
"unreviewedCandidates": {
"type": "array",
"items": {
"type": "object"
}
},
"authenticationRequired": {
"type": "boolean",
"const": false
}
},
"description": "Public Autocross Site Finder results from live map and imagery providers.",
"additionalProperties": true
},
"annotations": {
"title": "Find autocross sites",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Describes TuneWorks free public capabilities and connected garage capabilities for vehicles, setups, sessions, maintenance, shop lists, Share Build, and log history.
No parameters.
{
"name": "get_tuneworks_app_capabilities",
"title": "Get TuneWorks app capabilities",
"description": "Describes TuneWorks free public capabilities and connected garage capabilities for vehicles, setups, sessions, maintenance, shop lists, Share Build, and log history.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"product",
"publicScope",
"authenticatedScope"
],
"properties": {
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"product": {
"type": "string"
},
"nextStep": {
"type": "object",
"required": [
"label",
"tool",
"url"
],
"properties": {
"url": {
"type": "string"
},
"tool": {
"type": "string",
"const": "get_garage_summary"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
},
"actionTools": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"reason",
"requiresExplicitConfirmation"
],
"properties": {
"name": {
"type": "string"
},
"reason": {
"type": "string"
},
"requiresExplicitConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"publicScope": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"activationFlow": {
"type": "array",
"items": {
"type": "object",
"required": [
"stage",
"outcome",
"actionTools"
],
"properties": {
"stage": {
"enum": [
"empty_garage",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"outcome": {
"type": "string"
},
"actionTools": {
"type": "array",
"items": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"allowedObjects": {
"type": "array",
"items": {
"type": "string"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"authenticatedScope": {
"type": "string"
},
"capabilityBlockers": {
"type": "array",
"items": {
"type": "object",
"required": [
"capability",
"reason",
"url"
],
"properties": {
"url": {
"type": "string"
},
"reason": {
"type": "string"
},
"capability": {
"type": "string"
}
},
"additionalProperties": false
}
},
"unavailableObjects": {
"type": "array",
"items": {
"type": "string"
}
},
"requiresAuthenticationForAppData": {
"type": "boolean"
}
},
"description": "TuneWorks MCP capability summary covering public tools, authenticated app scope, unavailable objects, and action tools.",
"additionalProperties": true
},
"annotations": {
"title": "Get TuneWorks app capabilities",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns authoritative allowed values for constrained TuneWorks write fields, including live DB-backed App Metadata. Call this before writes whose field descriptions reference App Metadata.
No parameters.
{
"name": "get_tuneworks_write_options",
"title": "Get TuneWorks write options",
"description": "Returns authoritative allowed values for constrained TuneWorks write fields, including live DB-backed App Metadata. Call this before writes whose field descriptions reference App Metadata.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool",
"sourceOfTruth",
"appMetadata",
"fieldBindings",
"staticOptions",
"unitSettings"
],
"properties": {
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"appMetadata": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"unitSettings": {
"type": "array",
"items": {
"type": "object"
}
},
"fieldBindings": {
"type": "array",
"items": {
"type": "object"
}
},
"sourceOfTruth": {
"type": "string"
},
"staticOptions": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Authoritative live and shared option sets for TuneWorks MCP write fields.",
"additionalProperties": true
},
"annotations": {
"title": "Get TuneWorks write options",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Adds a vehicle to the connected user’s TuneWorks garage so setup, session, modification, maintenance, and optimization context can be attached. Deletes are not supported.
| Parameter | Type | Description |
|---|---|---|
| vin | string | |
| fuel * | string | one of ["gasoline","ethanol","methanol","diesel"] |
| make * | string | |
| year * | number | |
| model * | string | |
| owner | string | Vehicle owner. Defaults to the connected TuneWorks user when omitted. |
| mileage | string | |
| purpose * | string | TuneWorks vehicle purpose; Track day / HPDE represents a general track car. |
| subModel | string | |
| aspiration * | string | one of ["normally_aspirated","turbocharged","supercharged"] |
| engineType * | string | one of ["piston","rotary"] |
| fuelRating * | string | |
| engineHours | string | |
| engineModel | string | |
| displacement * | string | |
| modifications | string | |
| transmissionType | string | one of ["manual","automatic","cvt",""] |
| cylindersOrRotors * | string | |
| transmissionSpeeds | string | one of ["","3","4","5","6","7","8","9","10","continuous"] |
{
"name": "create_vehicle",
"title": "Create vehicle",
"description": "Adds a vehicle to the connected user’s TuneWorks garage so setup, session, modification, maintenance, and optimization context can be attached. Deletes are not supported.",
"inputSchema": {
"type": "object",
"required": [
"make",
"model",
"year",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating"
],
"properties": {
"vin": {
"type": "string"
},
"fuel": {
"enum": [
"gasoline",
"ethanol",
"methanol",
"diesel"
],
"type": "string"
},
"make": {
"type": "string"
},
"year": {
"type": "number"
},
"model": {
"type": "string"
},
"owner": {
"type": "string",
"description": "Vehicle owner. Defaults to the connected TuneWorks user when omitted."
},
"mileage": {
"type": "string"
},
"purpose": {
"enum": [
"Autocross racing",
"Circuit racing",
"Circle track racing",
"Drag racing",
"Drift racing",
"Hill climb",
"Land speed racing",
"Off-road racing",
"Rally racing",
"Street",
"Time attack",
"Track day / HPDE",
"Other"
],
"type": "string",
"description": "TuneWorks vehicle purpose; Track day / HPDE represents a general track car."
},
"subModel": {
"type": "string"
},
"aspiration": {
"enum": [
"normally_aspirated",
"turbocharged",
"supercharged"
],
"type": "string"
},
"engineType": {
"enum": [
"piston",
"rotary"
],
"type": "string"
},
"fuelRating": {
"type": "string"
},
"engineHours": {
"type": "string"
},
"engineModel": {
"type": "string"
},
"displacement": {
"type": "string"
},
"modifications": {
"type": "string"
},
"transmissionType": {
"enum": [
"manual",
"automatic",
"cvt",
""
],
"type": "string"
},
"cylindersOrRotors": {
"type": "string"
},
"transmissionSpeeds": {
"enum": [
"",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"continuous"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create vehicle",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Edits an existing vehicle in the connected user’s TuneWorks garage. Deletes are not supported.
| Parameter | Type | Description |
|---|---|---|
| vin | string | |
| fuel | string | one of ["gasoline","ethanol","methanol","diesel"] |
| make | string | |
| year | number | |
| model | string | |
| owner | string | |
| mileage | string | |
| purpose | string | one of ["Autocross racing","Circuit racing","Circle track racing","Drag racing","Drift racing","Hill climb","Land speed racing","Off-road racing","Rally racing","Street","Time attack","Track day / HPDE","Oth… |
| subModel | string | |
| vehicleId * | string | |
| aspiration | string | one of ["normally_aspirated","turbocharged","supercharged"] |
| engineType | string | one of ["piston","rotary"] |
| fuelRating | string | |
| engineHours | string | |
| engineModel | string | |
| displacement | string | |
| modifications | string | |
| transmissionType | string | one of ["manual","automatic","cvt",""] |
| cylindersOrRotors | string | |
| expectedUpdatedAt | string | Optional optimistic-concurrency timestamp from a previous TuneWorks response. |
| transmissionSpeeds | string | one of ["","3","4","5","6","7","8","9","10","continuous"] |
{
"name": "update_vehicle",
"title": "Update vehicle",
"description": "Edits an existing vehicle in the connected user’s TuneWorks garage. Deletes are not supported.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vin": {
"type": "string"
},
"fuel": {
"enum": [
"gasoline",
"ethanol",
"methanol",
"diesel"
],
"type": "string"
},
"make": {
"type": "string"
},
"year": {
"type": "number"
},
"model": {
"type": "string"
},
"owner": {
"type": "string"
},
"mileage": {
"type": "string"
},
"purpose": {
"enum": [
"Autocross racing",
"Circuit racing",
"Circle track racing",
"Drag racing",
"Drift racing",
"Hill climb",
"Land speed racing",
"Off-road racing",
"Rally racing",
"Street",
"Time attack",
"Track day / HPDE",
"Other"
],
"type": "string"
},
"subModel": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"aspiration": {
"enum": [
"normally_aspirated",
"turbocharged",
"supercharged"
],
"type": "string"
},
"engineType": {
"enum": [
"piston",
"rotary"
],
"type": "string"
},
"fuelRating": {
"type": "string"
},
"engineHours": {
"type": "string"
},
"engineModel": {
"type": "string"
},
"displacement": {
"type": "string"
},
"modifications": {
"type": "string"
},
"transmissionType": {
"enum": [
"manual",
"automatic",
"cvt",
""
],
"type": "string"
},
"cylindersOrRotors": {
"type": "string"
},
"expectedUpdatedAt": {
"type": "string",
"description": "Optional optimistic-concurrency timestamp from a previous TuneWorks response."
},
"transmissionSpeeds": {
"enum": [
"",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"continuous"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update vehicle",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List bounded structured modifications for an accessible TuneWorks vehicle.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| vehicleId * | string |
{
"name": "list_vehicle_modifications",
"title": "List vehicle modifications",
"description": "List bounded structured modifications for an accessible TuneWorks vehicle.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1
},
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List vehicle modifications",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one structured modification from an accessible TuneWorks vehicle.
| Parameter | Type | Description |
|---|---|---|
| vehicleId * | string | |
| modificationId * | string |
{
"name": "get_vehicle_modification",
"title": "Get vehicle modification",
"description": "Read one structured modification from an accessible TuneWorks vehicle.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"modificationId"
],
"properties": {
"vehicleId": {
"type": "string"
},
"modificationId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Get vehicle modification",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Create a structured modification on an editable TuneWorks vehicle. Load the authoritative write-options read tool first for live category, system, and purpose values.
| Parameter | Type | Description |
|---|---|---|
| cost | number | |
| brand * | string | |
| notes | string | |
| status * | string | one of ["Planned","Purchased","Installed","Removed","Sold","Canceled"] |
| system * | string | Enabled vehicle_mod_system label from the authoritative write-options read tool. |
| purpose | string | Optional enabled vehicle_mod_purpose label from the authoritative write-options read tool. |
| category * | string | Enabled vehicle_mod_category label from the authoritative write-options read tool. |
| partName * | string | |
| quantity | number | |
| laborCost | number | |
| removedAt | string | |
| vehicleId * | string | |
| partNumber | string | |
| installHours | string | |
| dateInstalled | string | |
| datePurchased | string | |
| purchasedFrom | string | |
| replacedModId | string | |
| installMileage | string | |
| installedByName | string |
{
"name": "create_vehicle_modification",
"title": "Create vehicle modification",
"description": "Create a structured modification on an editable TuneWorks vehicle. Load the authoritative write-options read tool first for live category, system, and purpose values.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"category",
"system",
"status",
"brand",
"partName"
],
"properties": {
"cost": {
"type": "number"
},
"brand": {
"type": "string"
},
"notes": {
"type": "string"
},
"status": {
"enum": [
"Planned",
"Purchased",
"Installed",
"Removed",
"Sold",
"Canceled"
],
"type": "string"
},
"system": {
"type": "string",
"description": "Enabled vehicle_mod_system label from the authoritative write-options read tool."
},
"purpose": {
"type": "string",
"description": "Optional enabled vehicle_mod_purpose label from the authoritative write-options read tool."
},
"category": {
"type": "string",
"description": "Enabled vehicle_mod_category label from the authoritative write-options read tool."
},
"partName": {
"type": "string"
},
"quantity": {
"type": "number"
},
"laborCost": {
"type": "number"
},
"removedAt": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"partNumber": {
"type": "string"
},
"installHours": {
"type": "string"
},
"dateInstalled": {
"type": "string"
},
"datePurchased": {
"type": "string"
},
"purchasedFrom": {
"type": "string"
},
"replacedModId": {
"type": "string"
},
"installMileage": {
"type": "string"
},
"installedByName": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create vehicle modification",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Update a structured modification on an editable TuneWorks vehicle. Load the authoritative write-options read tool first for live category, system, and purpose values.
| Parameter | Type | Description |
|---|---|---|
| cost | number | |
| brand | string | |
| notes | string | |
| status | string | one of ["Planned","Purchased","Installed","Removed","Sold","Canceled"] |
| system | string | Enabled vehicle_mod_system label from the authoritative write-options read tool. |
| purpose | string | Optional enabled vehicle_mod_purpose label from the authoritative write-options read tool. |
| category | string | Enabled vehicle_mod_category label from the authoritative write-options read tool. |
| partName | string | |
| quantity | number | |
| laborCost | number | |
| removedAt | string | |
| vehicleId * | string | |
| partNumber | string | |
| installHours | string | |
| dateInstalled | string | |
| datePurchased | string | |
| purchasedFrom | string | |
| replacedModId | string | |
| installMileage | string | |
| modificationId * | string | |
| installedByName | string |
{
"name": "update_vehicle_modification",
"title": "Update vehicle modification",
"description": "Update a structured modification on an editable TuneWorks vehicle. Load the authoritative write-options read tool first for live category, system, and purpose values.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"modificationId"
],
"properties": {
"cost": {
"type": "number"
},
"brand": {
"type": "string"
},
"notes": {
"type": "string"
},
"status": {
"enum": [
"Planned",
"Purchased",
"Installed",
"Removed",
"Sold",
"Canceled"
],
"type": "string"
},
"system": {
"type": "string",
"description": "Enabled vehicle_mod_system label from the authoritative write-options read tool."
},
"purpose": {
"type": "string",
"description": "Optional enabled vehicle_mod_purpose label from the authoritative write-options read tool."
},
"category": {
"type": "string",
"description": "Enabled vehicle_mod_category label from the authoritative write-options read tool."
},
"partName": {
"type": "string"
},
"quantity": {
"type": "number"
},
"laborCost": {
"type": "number"
},
"removedAt": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"partNumber": {
"type": "string"
},
"installHours": {
"type": "string"
},
"dateInstalled": {
"type": "string"
},
"datePurchased": {
"type": "string"
},
"purchasedFrom": {
"type": "string"
},
"replacedModId": {
"type": "string"
},
"installMileage": {
"type": "string"
},
"modificationId": {
"type": "string"
},
"installedByName": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update vehicle modification",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Mark a modification canceled so it remains in vehicle history. Requires explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| confirmed * | boolean | |
| vehicleId * | string | |
| modificationId * | string |
{
"name": "archive_vehicle_modification",
"title": "Archive vehicle modification",
"description": "Mark a modification canceled so it remains in vehicle history. Requires explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"modificationId",
"confirmed"
],
"properties": {
"confirmed": {
"type": "boolean"
},
"vehicleId": {
"type": "string"
},
"modificationId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Archive vehicle modification",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Permanently delete a vehicle modification and its files. Requires explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| confirmed * | boolean | |
| vehicleId * | string | |
| modificationId * | string |
{
"name": "delete_vehicle_modification",
"title": "Delete vehicle modification",
"description": "Permanently delete a vehicle modification and its files. Requires explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"modificationId",
"confirmed"
],
"properties": {
"confirmed": {
"type": "boolean"
},
"vehicleId": {
"type": "string"
},
"modificationId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Delete vehicle modification",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Returns the connected garage, its activation stage, missing baseline data, and the next available actions toward vehicle optimization.
No parameters.
{
"name": "get_garage_summary",
"title": "Get garage summary",
"description": "Returns the connected garage, its activation stage, missing baseline data, and the next available actions toward vehicle optimization.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"summary": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"onboarding": {
"type": "object",
"required": [
"state",
"suggestedAction",
"initialFields",
"requiresUserConfirmation"
],
"properties": {
"state": {
"type": "string",
"const": "empty_garage"
},
"initialFields": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
},
"suggestedAction": {
"type": "string",
"const": "create_vehicle"
},
"requiresUserConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"recentSetups": {
"type": "array",
"items": {
"type": "object"
}
},
"recentSessions": {
"type": "array",
"items": {
"type": "object"
}
},
"recentVehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"recentShopLists": {
"type": "array",
"items": {
"type": "object"
}
}
},
"description": "Connected garage summary with recent vehicles, setups, sessions, shop lists, counts, and app URL.",
"additionalProperties": true
},
"annotations": {
"title": "Get garage summary",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Lists vehicles saved in the connected user’s TuneWorks app garage and reports the next activation action when the garage is empty.
| Parameter | Type | Description |
|---|---|---|
| limit | number |
{
"name": "list_vehicles",
"title": "List vehicles",
"description": "Lists vehicles saved in the connected user’s TuneWorks app garage and reports the next activation action when the garage is empty.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List vehicles",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns one saved TuneWorks vehicle with modifications, setups, sessions, maintenance, lists, log metadata, optimization readiness, and next actions.
| Parameter | Type | Description |
|---|---|---|
| vehicleId * | string | Stable TuneWorks vehicle ID from an authorized TuneWorks response. |
{
"name": "get_vehicle_context",
"title": "Get vehicle context",
"description": "Returns one saved TuneWorks vehicle with modifications, setups, sessions, maintenance, lists, log metadata, optimization readiness, and next actions.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string",
"description": "Stable TuneWorks vehicle ID from an authorized TuneWorks response."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"vehicle": {
"type": "object"
},
"shopLists": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"recentLogs": {
"type": "array",
"items": {
"type": "object"
}
},
"maintenance": {
"type": [
"object",
"null"
]
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"recentSetups": {
"type": "array",
"items": {
"type": "object"
}
},
"recentSessions": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"recentModifications": {
"type": "array",
"items": {
"type": "object"
}
},
"optimizationReadiness": {
"type": "object",
"required": [
"ready",
"stage",
"missingData",
"recommendedData"
],
"properties": {
"ready": {
"type": "boolean"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
}
},
"description": "Connected vehicle optimization context with modifications, setups, sessions, log metadata, maintenance, readiness, and next actions.",
"additionalProperties": true
},
"annotations": {
"title": "Get vehicle context",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List bounded metadata for logs attached to one connected TuneWorks vehicle. Raw log samples are not returned.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| vehicleId * | string |
{
"name": "list_logs",
"title": "List log metadata",
"description": "List bounded metadata for logs attached to one connected TuneWorks vehicle. Raw log samples are not returned.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1
},
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List log metadata",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read bounded metadata, channel schema summary, and saved focus window for one accessible TuneWorks log. Raw log samples are not returned.
| Parameter | Type | Description |
|---|---|---|
| logId * | string |
{
"name": "get_log_context",
"title": "Get bounded log context",
"description": "Read bounded metadata, channel schema summary, and saved focus window for one accessible TuneWorks log. Raw log samples are not returned.",
"inputSchema": {
"type": "object",
"required": [
"logId"
],
"properties": {
"logId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Get bounded log context",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List recent AI Log Tuner conversations owned by the connected TuneWorks user. Returns conversation metadata without message contents.
| Parameter | Type | Description |
|---|---|---|
| limit | number |
{
"name": "list_ai_log_tuner_transcripts",
"title": "List AI Log Tuner transcripts",
"description": "List recent AI Log Tuner conversations owned by the connected TuneWorks user. Returns conversation metadata without message contents.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 5,
"maximum": 20,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List AI Log Tuner transcripts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read the ordered messages and saved analysis summaries for one AI Log Tuner conversation owned by the connected TuneWorks user.
| Parameter | Type | Description |
|---|---|---|
| logId * | string | Stable TuneWorks log ID for the requested conversation. |
{
"name": "get_ai_log_tuner_transcript",
"title": "Get AI Log Tuner transcript",
"description": "Read the ordered messages and saved analysis summaries for one AI Log Tuner conversation owned by the connected TuneWorks user.",
"inputSchema": {
"type": "object",
"required": [
"logId"
],
"properties": {
"logId": {
"type": "string",
"description": "Stable TuneWorks log ID for the requested conversation."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Get AI Log Tuner transcript",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List recent AI Race Engineer conversations owned by the connected TuneWorks user. May be filtered to one vehicle.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| vehicleId | string |
{
"name": "list_ai_race_engineer_transcripts",
"title": "List AI Race Engineer transcripts",
"description": "List recent AI Race Engineer conversations owned by the connected TuneWorks user. May be filtered to one vehicle.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1
},
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List AI Race Engineer transcripts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one AI Race Engineer conversation and its ordered messages. Internal execution debug traces are not returned.
| Parameter | Type | Description |
|---|---|---|
| chatId * | string | Stable TuneWorks Race Engineer conversation ID. |
{
"name": "get_ai_race_engineer_transcript",
"title": "Get AI Race Engineer transcript",
"description": "Read one AI Race Engineer conversation and its ordered messages. Internal execution debug traces are not returned.",
"inputSchema": {
"type": "object",
"required": [
"chatId"
],
"properties": {
"chatId": {
"type": "string",
"description": "Stable TuneWorks Race Engineer conversation ID."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Get AI Race Engineer transcript",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Archive a connected user vehicle using TuneWorks soft-delete behavior. Requires explicit user confirmation and never hard-deletes data.
| Parameter | Type | Description |
|---|---|---|
| confirmed * | boolean | |
| vehicleId * | string |
{
"name": "archive_vehicle",
"title": "Archive vehicle",
"description": "Archive a connected user vehicle using TuneWorks soft-delete behavior. Requires explicit user confirmation and never hard-deletes data.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"confirmed"
],
"properties": {
"confirmed": {
"type": "boolean"
},
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Archive vehicle",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Lists chassis setups and setup history saved in the connected TuneWorks account.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| vehicleId | string | Optional TuneWorks vehicle ID to filter setups. |
{
"name": "list_setups",
"title": "List setups",
"description": "Lists chassis setups and setup history saved in the connected TuneWorks account.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1
},
"vehicleId": {
"type": "string",
"description": "Optional TuneWorks vehicle ID to filter setups."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List setups",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Saves a new TuneWorks setup for a vehicle. Deletes are not supported.
| Parameter | Type | Description |
|---|---|---|
| setupData | object | Setup fields such as setup goals, overall weight/balance, tire summary, front/rear ride height, front/rear total toe, per-corner tires, pressures, alignment, ride height, springs, dampers, corner weights, brake/balance, aero, electronics, and notes. |
| setupDate * | string | Setup date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred. |
| setupName * | string | |
| vehicleId * | string | |
| dataLogIds | array | |
| performedBy | string | Person who performed the setup. If omitted, TuneWorks uses the connected user name/email. |
| influencedSessionId | string |
{
"name": "create_setup",
"title": "Create setup",
"description": "Saves a new TuneWorks setup for a vehicle. Deletes are not supported.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"setupName",
"setupDate"
],
"properties": {
"setupData": {
"type": "object",
"description": "Setup fields such as setup goals, overall weight/balance, tire summary, front/rear ride height, front/rear total toe, per-corner tires, pressures, alignment, ride height, springs, dampers, corner weights, brake/balance, aero, electronics, and notes.",
"additionalProperties": true
},
"setupDate": {
"type": "string",
"description": "Setup date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred."
},
"setupName": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"dataLogIds": {
"type": "array",
"items": {
"type": "string"
}
},
"performedBy": {
"type": "string",
"description": "Person who performed the setup. If omitted, TuneWorks uses the connected user name/email."
},
"influencedSessionId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create setup",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Edits an existing TuneWorks setup revision. Deletes are not supported.
| Parameter | Type | Description |
|---|---|---|
| setupId * | string | |
| revision | number | Optional setup revision number. If omitted, TuneWorks updates the latest revision. |
| setupData | object | Partial setup fields to change, including setup goals, overall weight/balance, tire summary, front/rear ride height, front/rear total toe, per-corner tires, alignment, ride height, springs, dampers, corner weights, brake/balance, aero, electronics, and notes. Numeric and boolean values are accepted … |
| setupDate | string | Setup date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred. |
| setupName | string | |
| vehicleId | string | |
| dataLogIds | array | |
| performedBy | string | Person who performed the setup. If omitted, TuneWorks uses the connected user name/email. |
| expectedUpdatedAt | string | Optional optimistic-concurrency timestamp from a previous TuneWorks response. |
| influencedSessionId | string |
{
"name": "update_setup",
"title": "Update setup",
"description": "Edits an existing TuneWorks setup revision. Deletes are not supported.",
"inputSchema": {
"type": "object",
"required": [
"setupId"
],
"properties": {
"setupId": {
"type": "string"
},
"revision": {
"type": "number",
"description": "Optional setup revision number. If omitted, TuneWorks updates the latest revision."
},
"setupData": {
"type": "object",
"description": "Partial setup fields to change, including setup goals, overall weight/balance, tire summary, front/rear ride height, front/rear total toe, per-corner tires, alignment, ride height, springs, dampers, corner weights, brake/balance, aero, electronics, and notes. Numeric and boolean values are accepted and saved as setup text values.",
"additionalProperties": true
},
"setupDate": {
"type": "string",
"description": "Setup date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred."
},
"setupName": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"dataLogIds": {
"type": "array",
"items": {
"type": "string"
}
},
"performedBy": {
"type": "string",
"description": "Person who performed the setup. If omitted, TuneWorks uses the connected user name/email."
},
"expectedUpdatedAt": {
"type": "string",
"description": "Optional optimistic-concurrency timestamp from a previous TuneWorks response."
},
"influencedSessionId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update setup",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Archive all active revisions of a connected user setup. Requires explicit user confirmation and never hard-deletes data.
| Parameter | Type | Description |
|---|---|---|
| setupId * | string | |
| confirmed * | boolean |
{
"name": "archive_setup",
"title": "Archive setup",
"description": "Archive all active revisions of a connected user setup. Requires explicit user confirmation and never hard-deletes data.",
"inputSchema": {
"type": "object",
"required": [
"setupId",
"confirmed"
],
"properties": {
"setupId": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Archive setup",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Lists driving sessions, events, track days, autocross runs, and session notes saved in TuneWorks.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| vehicleId | string | Optional TuneWorks vehicle ID to filter sessions. |
{
"name": "list_sessions",
"title": "List sessions",
"description": "Lists driving sessions, events, track days, autocross runs, and session notes saved in TuneWorks.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1
},
"vehicleId": {
"type": "string",
"description": "Optional TuneWorks vehicle ID to filter sessions."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List sessions",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Saves a new TuneWorks driving session. Deletes are not supported.
| Parameter | Type | Description |
|---|---|---|
| track | string | |
| worked | string | |
| braking | string | |
| drivers | string | |
| setupId | string | |
| bestTime | string | |
| location | string | |
| traction | string | |
| eventName | string | |
| eventType * | string | Enabled session_type label; live options are returned by the authoritative write-options read tool. |
| midCorner | string | |
| vehicleId * | string | |
| cornerExit | string | |
| dataLogIds | array | |
| didNotWork | string | |
| cornerEntry | string | |
| sessionDate * | string | Session date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred. |
| sessionFormat * | string | Enabled session_format label; live options are returned by the authoritative write-options read tool. |
| overallBalance | string | |
| performanceFigures | string | |
| suggestedSetupChange | string | |
| additionalSessionDetails | string |
{
"name": "create_session",
"title": "Create session",
"description": "Saves a new TuneWorks driving session. Deletes are not supported.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"sessionDate",
"sessionFormat",
"eventType"
],
"properties": {
"track": {
"type": "string"
},
"worked": {
"type": "string"
},
"braking": {
"type": "string"
},
"drivers": {
"type": "string"
},
"setupId": {
"type": "string"
},
"bestTime": {
"type": "string"
},
"location": {
"type": "string"
},
"traction": {
"type": "string"
},
"eventName": {
"type": "string"
},
"eventType": {
"enum": [
"Autocross",
"Circuit racing",
"Drag racing",
"Drift",
"Dyno",
"Hill climb",
"Rally",
"Street drive",
"Test / tuning",
"Time attack",
"Track day / HPDE",
"Troubleshooting",
"Other"
],
"type": "string",
"description": "Enabled session_type label; live options are returned by the authoritative write-options read tool."
},
"midCorner": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"cornerExit": {
"type": "string"
},
"dataLogIds": {
"type": "array",
"items": {
"type": "string"
}
},
"didNotWork": {
"type": "string"
},
"cornerEntry": {
"type": "string"
},
"sessionDate": {
"type": "string",
"description": "Session date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred."
},
"sessionFormat": {
"enum": [
"Competition",
"Data collection",
"Practice",
"Qualifying",
"Race",
"Testing",
"Troubleshooting",
"Tuning",
"Other"
],
"type": "string",
"description": "Enabled session_format label; live options are returned by the authoritative write-options read tool."
},
"overallBalance": {
"type": "string"
},
"performanceFigures": {
"type": "string"
},
"suggestedSetupChange": {
"type": "string"
},
"additionalSessionDetails": {
"type": "string"
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create session",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Edits an existing TuneWorks driving session. Deletes are not supported.
| Parameter | Type | Description |
|---|---|---|
| track | string | |
| worked | string | |
| braking | string | |
| drivers | string | |
| setupId | string | |
| bestTime | string | |
| location | string | |
| traction | string | |
| eventName | string | |
| eventType | string | Enabled session_type label; live options are returned by the authoritative write-options read tool. |
| midCorner | string | |
| sessionId * | string | |
| vehicleId | string | |
| cornerExit | string | |
| dataLogIds | array | |
| didNotWork | string | |
| cornerEntry | string | |
| sessionDate | string | Session date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred. |
| sessionFormat | string | Enabled session_format label; live options are returned by the authoritative write-options read tool. |
| overallBalance | string | |
| expectedUpdatedAt | string | Optional optimistic-concurrency timestamp from a previous TuneWorks response. |
| performanceFigures | string | |
| suggestedSetupChange | string | |
| additionalSessionDetails | string |
{
"name": "update_session",
"title": "Update session",
"description": "Edits an existing TuneWorks driving session. Deletes are not supported.",
"inputSchema": {
"type": "object",
"required": [
"sessionId"
],
"properties": {
"track": {
"type": "string"
},
"worked": {
"type": "string"
},
"braking": {
"type": "string"
},
"drivers": {
"type": "string"
},
"setupId": {
"type": "string"
},
"bestTime": {
"type": "string"
},
"location": {
"type": "string"
},
"traction": {
"type": "string"
},
"eventName": {
"type": "string"
},
"eventType": {
"enum": [
"Autocross",
"Circuit racing",
"Drag racing",
"Drift",
"Dyno",
"Hill climb",
"Rally",
"Street drive",
"Test / tuning",
"Time attack",
"Track day / HPDE",
"Troubleshooting",
"Other"
],
"type": "string",
"description": "Enabled session_type label; live options are returned by the authoritative write-options read tool."
},
"midCorner": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"cornerExit": {
"type": "string"
},
"dataLogIds": {
"type": "array",
"items": {
"type": "string"
}
},
"didNotWork": {
"type": "string"
},
"cornerEntry": {
"type": "string"
},
"sessionDate": {
"type": "string",
"description": "Session date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred."
},
"sessionFormat": {
"enum": [
"Competition",
"Data collection",
"Practice",
"Qualifying",
"Race",
"Testing",
"Troubleshooting",
"Tuning",
"Other"
],
"type": "string",
"description": "Enabled session_format label; live options are returned by the authoritative write-options read tool."
},
"overallBalance": {
"type": "string"
},
"expectedUpdatedAt": {
"type": "string",
"description": "Optional optimistic-concurrency timestamp from a previous TuneWorks response."
},
"performanceFigures": {
"type": "string"
},
"suggestedSetupChange": {
"type": "string"
},
"additionalSessionDetails": {
"type": "string"
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update session",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Create an additive copy of an accessible TuneWorks driving session.
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string |
{
"name": "copy_session",
"title": "Copy session",
"description": "Create an additive copy of an accessible TuneWorks driving session.",
"inputSchema": {
"type": "object",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Copy session",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Archive a connected user driving session. Requires explicit user confirmation and never hard-deletes data.
| Parameter | Type | Description |
|---|---|---|
| confirmed * | boolean | |
| sessionId * | string |
{
"name": "archive_session",
"title": "Archive session",
"description": "Archive a connected user driving session. Requires explicit user confirmation and never hard-deletes data.",
"inputSchema": {
"type": "object",
"required": [
"sessionId",
"confirmed"
],
"properties": {
"confirmed": {
"type": "boolean"
},
"sessionId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Archive session",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Lists service reminders, maintenance history, due work, and completed maintenance saved in TuneWorks.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| vehicleId | string | Optional TuneWorks vehicle ID to filter maintenance. |
{
"name": "list_maintenance",
"title": "List maintenance",
"description": "Lists service reminders, maintenance history, due work, and completed maintenance saved in TuneWorks.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1
},
"vehicleId": {
"type": "string",
"description": "Optional TuneWorks vehicle ID to filter maintenance."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List maintenance",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Creates a TuneWorks maintenance reminder or service item. Deletes are not supported.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| notes | string | |
| dueDate | string | Optional reminder date in YYYY-MM-DD format. Omit when no reminder is wanted. |
| category * | string | Enabled maintenance_category label from the authoritative write-options read tool. |
| doneDate | string | Optional service completion date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred. |
| vehicleId * | string | |
| intervalType | string | one of ["manual","calendar","mileage"] |
| intervalValue | number |
{
"name": "create_maintenance",
"title": "Create maintenance",
"description": "Creates a TuneWorks maintenance reminder or service item. Deletes are not supported.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"name",
"category"
],
"properties": {
"name": {
"type": "string"
},
"notes": {
"type": "string"
},
"dueDate": {
"type": "string",
"description": "Optional reminder date in YYYY-MM-DD format. Omit when no reminder is wanted."
},
"category": {
"type": "string",
"description": "Enabled maintenance_category label from the authoritative write-options read tool."
},
"doneDate": {
"type": "string",
"description": "Optional service completion date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred."
},
"vehicleId": {
"type": "string"
},
"intervalType": {
"enum": [
"manual",
"calendar",
"mileage"
],
"type": "string"
},
"intervalValue": {
"type": "number"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create maintenance",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Edits a TuneWorks maintenance reminder or service item. Deletes are not supported.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| notes | string | |
| dueDate | string | Optional reminder date in YYYY-MM-DD format. Omit when no reminder is wanted. |
| category | string | Enabled maintenance_category label from the authoritative write-options read tool. |
| doneDate | string | Service completion date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred. |
| trackerId * | string | |
| vehicleId * | string | |
| intervalType | string | one of ["manual","calendar","mileage"] |
| intervalValue | number |
{
"name": "update_maintenance",
"title": "Update maintenance",
"description": "Edits a TuneWorks maintenance reminder or service item. Deletes are not supported.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"trackerId"
],
"properties": {
"name": {
"type": "string"
},
"notes": {
"type": "string"
},
"dueDate": {
"type": "string",
"description": "Optional reminder date in YYYY-MM-DD format. Omit when no reminder is wanted."
},
"category": {
"type": "string",
"description": "Enabled maintenance_category label from the authoritative write-options read tool."
},
"doneDate": {
"type": "string",
"description": "Service completion date in YYYY-MM-DD format. Natural date strings are accepted but YYYY-MM-DD is preferred."
},
"trackerId": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"intervalType": {
"enum": [
"manual",
"calendar",
"mileage"
],
"type": "string"
},
"intervalValue": {
"type": "number"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update maintenance",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Archive a connected user maintenance item. Requires explicit user confirmation and never hard-deletes data.
| Parameter | Type | Description |
|---|---|---|
| confirmed * | boolean | |
| trackerId * | string | |
| vehicleId * | string |
{
"name": "archive_maintenance",
"title": "Archive maintenance item",
"description": "Archive a connected user maintenance item. Requires explicit user confirmation and never hard-deletes data.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"trackerId",
"confirmed"
],
"properties": {
"confirmed": {
"type": "boolean"
},
"trackerId": {
"type": "string"
},
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Archive maintenance item",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Lists reusable shop lists, event prep lists, task lists, and parts lists saved in TuneWorks.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| purpose | string | Optional enabled shop_list_purpose value from the authoritative write-options read tool. |
| vehicleId | string | Optional TuneWorks vehicle ID to filter shop lists. |
{
"name": "list_shop_lists",
"title": "List shop lists",
"description": "Lists reusable shop lists, event prep lists, task lists, and parts lists saved in TuneWorks.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 25,
"minimum": 1
},
"purpose": {
"type": "string",
"description": "Optional enabled shop_list_purpose value from the authoritative write-options read tool."
},
"vehicleId": {
"type": "string",
"description": "Optional TuneWorks vehicle ID to filter shop lists."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List shop lists",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one connected user shop list with its categories and items.
| Parameter | Type | Description |
|---|---|---|
| listId * | string |
{
"name": "get_shop_list",
"title": "Get shop list",
"description": "Read one connected user shop list with its categories and items.",
"inputSchema": {
"type": "object",
"required": [
"listId"
],
"properties": {
"listId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"listId": {
"type": "string"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"actionType": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Authenticated shop-list read or action result.",
"additionalProperties": true
},
"annotations": {
"title": "Get shop list",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Lists individual items and completion status in one connected user shop list, with optional filtering for open or completed items.
| Parameter | Type | Description |
|---|---|---|
| listId * | string | |
| status | string | Optional item-status filter; open represents remaining or not-done items. |
{
"name": "list_shop_list_items",
"title": "List shop list items",
"description": "Lists individual items and completion status in one connected user shop list, with optional filtering for open or completed items.",
"inputSchema": {
"type": "object",
"required": [
"listId"
],
"properties": {
"listId": {
"type": "string"
},
"status": {
"enum": [
"open",
"done"
],
"type": "string",
"description": "Optional item-status filter; open represents remaining or not-done items."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"items": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"categories": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"itemStatusFilter": {
"type": [
"string",
"null"
]
}
},
"description": "Authenticated shop-list item results, optionally filtered to open or done items.",
"additionalProperties": true
},
"annotations": {
"title": "List shop list items",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Creates a TuneWorks shop list, task list, or parts list, optionally including categories and items.
| Parameter | Type | Description |
|---|---|---|
| note | string | |
| items | array | |
| title * | string | |
| status | string | one of ["open","completed"] |
| purpose * | string | Required enabled shop_list_purpose value from the authoritative write-options read tool. |
| setupId | string | |
| sessionId | string | |
| vehicleId | string | |
| categories | array |
{
"name": "create_shop_list",
"title": "Create shop list",
"description": "Creates a TuneWorks shop list, task list, or parts list, optionally including categories and items.",
"inputSchema": {
"type": "object",
"required": [
"title",
"purpose"
],
"properties": {
"note": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string"
},
"status": {
"enum": [
"open",
"done"
],
"type": "string"
},
"section": {
"type": "string"
},
"quantity": {
"type": "integer",
"maximum": 9999,
"minimum": 1
},
"sortOrder": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
}
},
"additionalProperties": false
}
},
"title": {
"type": "string"
},
"status": {
"enum": [
"open",
"completed"
],
"type": "string"
},
"purpose": {
"type": "string",
"description": "Required enabled shop_list_purpose value from the authoritative write-options read tool."
},
"setupId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"sortOrder": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create shop list",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Edits shop-list metadata or replaces the full categories and items collection.
| Parameter | Type | Description |
|---|---|---|
| note | string | |
| items | array | |
| title | string | |
| listId * | string | |
| status | string | one of ["open","completed"] |
| purpose | string | Enabled shop_list_purpose value from the authoritative write-options read tool. |
| setupId | string | |
| sessionId | string | |
| vehicleId | string | |
| categories | array |
{
"name": "update_shop_list",
"title": "Update shop list",
"description": "Edits shop-list metadata or replaces the full categories and items collection.",
"inputSchema": {
"type": "object",
"required": [
"listId"
],
"properties": {
"note": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string"
},
"status": {
"enum": [
"open",
"done"
],
"type": "string"
},
"section": {
"type": "string"
},
"quantity": {
"type": "integer",
"maximum": 9999,
"minimum": 1
},
"sortOrder": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
}
},
"additionalProperties": false
}
},
"title": {
"type": "string"
},
"listId": {
"type": "string"
},
"status": {
"enum": [
"open",
"completed"
],
"type": "string"
},
"purpose": {
"type": "string",
"description": "Enabled shop_list_purpose value from the authoritative write-options read tool."
},
"setupId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"sortOrder": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update shop list",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Atomically add one category to an existing editable shop list without replacing its existing categories or items.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| listId * | string | |
| sortOrder | integer |
{
"name": "add_shop_list_category",
"title": "Add shop list category",
"description": "Atomically add one category to an existing editable shop list without replacing its existing categories or items.",
"inputSchema": {
"type": "object",
"required": [
"listId",
"name"
],
"properties": {
"name": {
"type": "string"
},
"listId": {
"type": "string"
},
"sortOrder": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Authenticated atomic shop-list addition with the updated list, categories, and items.",
"additionalProperties": true
},
"annotations": {
"title": "Add shop list category",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Atomically add one item to an existing editable shop list without replacing existing items. If its category does not exist yet, TuneWorks creates it.
| Parameter | Type | Description |
|---|---|---|
| label * | string | |
| listId * | string | |
| status | string | one of ["open","done"] |
| section | string | Optional category name. |
| quantity | integer | |
| sortOrder | integer |
{
"name": "add_shop_list_item",
"title": "Add shop list item",
"description": "Atomically add one item to an existing editable shop list without replacing existing items. If its category does not exist yet, TuneWorks creates it.",
"inputSchema": {
"type": "object",
"required": [
"listId",
"label"
],
"properties": {
"label": {
"type": "string"
},
"listId": {
"type": "string"
},
"status": {
"enum": [
"open",
"done"
],
"type": "string"
},
"section": {
"type": "string",
"description": "Optional category name."
},
"quantity": {
"type": "integer",
"maximum": 9999,
"minimum": 1
},
"sortOrder": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Authenticated atomic shop-list addition with the updated list, categories, and items.",
"additionalProperties": true
},
"annotations": {
"title": "Add shop list item",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Create an editable copy of a connected user shop list with all item checks reset.
| Parameter | Type | Description |
|---|---|---|
| listId * | string |
{
"name": "copy_shop_list",
"title": "Copy shop list",
"description": "Create an editable copy of a connected user shop list with all item checks reset.",
"inputSchema": {
"type": "object",
"required": [
"listId"
],
"properties": {
"listId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"listId": {
"type": "string"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"actionType": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Authenticated shop-list read or action result.",
"additionalProperties": true
},
"annotations": {
"title": "Copy shop list",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Reset every item in a connected user shop list to unchecked/open.
| Parameter | Type | Description |
|---|---|---|
| listId * | string | |
| confirmed * | boolean |
{
"name": "reset_shop_list_items",
"title": "Reset shop list items",
"description": "Reset every item in a connected user shop list to unchecked/open.",
"inputSchema": {
"type": "object",
"required": [
"listId",
"confirmed"
],
"properties": {
"listId": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"listId": {
"type": "string"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"actionType": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Authenticated shop-list read or action result.",
"additionalProperties": true
},
"annotations": {
"title": "Reset shop list items",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Atomically check or uncheck one shop-list item, change its quantity, or do both.
| Parameter | Type | Description |
|---|---|---|
| itemId * | string | |
| listId * | string | |
| status | string | one of ["open","done"] |
| quantity | integer |
{
"name": "update_shop_list_item",
"title": "Update shop list item",
"description": "Atomically check or uncheck one shop-list item, change its quantity, or do both.",
"inputSchema": {
"type": "object",
"required": [
"listId",
"itemId"
],
"properties": {
"itemId": {
"type": "string"
},
"listId": {
"type": "string"
},
"status": {
"enum": [
"open",
"done"
],
"type": "string"
},
"quantity": {
"type": "integer",
"maximum": 9999,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"listId": {
"type": "string"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"actionType": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Authenticated shop-list read or action result.",
"additionalProperties": true
},
"annotations": {
"title": "Update shop list item",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Archive a connected user shop list so it no longer appears in active lists. Requires explicit user confirmation.
| Parameter | Type | Description |
|---|---|---|
| listId * | string | |
| confirmed * | boolean | True indicates that the user explicitly confirmed archiving this list. |
{
"name": "archive_shop_list",
"title": "Archive shop list",
"description": "Archive a connected user shop list so it no longer appears in active lists. Requires explicit user confirmation.",
"inputSchema": {
"type": "object",
"required": [
"listId",
"confirmed"
],
"properties": {
"listId": {
"type": "string"
},
"confirmed": {
"type": "boolean",
"description": "True indicates that the user explicitly confirmed archiving this list."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"listId": {
"type": "string"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"actionType": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Authenticated shop-list read or action result.",
"additionalProperties": true
},
"annotations": {
"title": "Archive shop list",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Delete a connected user shop list from active use by safely archiving it. Requires explicit user confirmation and does not hard-delete history.
| Parameter | Type | Description |
|---|---|---|
| listId * | string | |
| confirmed * | boolean | True indicates that the user explicitly confirmed deleting this list. |
{
"name": "delete_shop_list",
"title": "Delete shop list",
"description": "Delete a connected user shop list from active use by safely archiving it. Requires explicit user confirmation and does not hard-delete history.",
"inputSchema": {
"type": "object",
"required": [
"listId",
"confirmed"
],
"properties": {
"listId": {
"type": "string"
},
"confirmed": {
"type": "boolean",
"description": "True indicates that the user explicitly confirmed deleting this list."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"listId": {
"type": "string"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"actionType": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"deletionMode": {
"enum": [
"archived"
],
"type": "string"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Confirmed shop-list deletion result. TuneWorks preserves history by archiving the list.",
"additionalProperties": true
},
"annotations": {
"title": "Delete shop list",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Lists existing TuneWorks vehicles, setups, and sessions available for Share Build.
| Parameter | Type | Description |
|---|---|---|
| vehicleId | string | Optional TuneWorks vehicle ID to narrow Share Build setup and session options. |
{
"name": "get_share_build_options",
"title": "Get Share Build options",
"description": "Lists existing TuneWorks vehicles, setups, and sessions available for Share Build.",
"inputSchema": {
"type": "object",
"properties": {
"vehicleId": {
"type": "string",
"description": "Optional TuneWorks vehicle ID to narrow Share Build setup and session options."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Share Build option lists for existing vehicles, setups, and sessions.",
"additionalProperties": true
},
"annotations": {
"title": "Get Share Build options",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Summarizes selected Share Build vehicle, setups, sessions, recipients, and message without sending email.
| Parameter | Type | Description |
|---|---|---|
| message | string | Optional message to include in the Share Build email. |
| setupIds | array | Optional TuneWorks setup IDs to include. |
| vehicleId * | string | TuneWorks vehicle ID selected for Share Build. |
| recipients | array | Recipient email addresses to preview. |
| sessionIds | array | Optional TuneWorks session IDs to include. |
{
"name": "preview_share_build",
"title": "Preview Share Build",
"description": "Summarizes selected Share Build vehicle, setups, sessions, recipients, and message without sending email.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000,
"description": "Optional message to include in the Share Build email."
},
"setupIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional TuneWorks setup IDs to include."
},
"vehicleId": {
"type": "string",
"description": "TuneWorks vehicle ID selected for Share Build."
},
"recipients": {
"type": "array",
"items": {
"type": "string",
"format": "email"
},
"maxItems": 3,
"description": "Recipient email addresses to preview."
},
"sessionIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional TuneWorks session IDs to include."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"preview": {
"type": "object"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"confirmationRequiredForSend": {
"type": "boolean"
}
},
"description": "Share Build preview with selected vehicle, recipients, message, setup/session counts, and confirmation requirement.",
"additionalProperties": true
},
"annotations": {
"title": "Preview Share Build",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read the connected user’s preferences, unit choices, and custom vehicle makes.
No parameters.
{
"name": "get_user_settings",
"title": "Get user settings",
"description": "Read the connected user’s preferences, unit choices, and custom vehicle makes.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Get user settings",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Update selected preferences for the connected TuneWorks user.
| Parameter | Type | Description |
|---|---|---|
| preferences * | object |
{
"name": "update_user_preferences",
"title": "Update user preferences",
"description": "Update selected preferences for the connected TuneWorks user.",
"inputSchema": {
"type": "object",
"required": [
"preferences"
],
"properties": {
"preferences": {
"type": "object",
"properties": {
"persona": {
"enum": [
"hobbyist",
"race_team",
"tuner",
"other"
],
"type": "string"
},
"displayName": {
"type": [
"string",
"null"
]
},
"customAiName": {
"type": [
"string",
"null"
]
},
"defaultTeamId": {
"type": [
"string",
"null"
]
},
"tuningSkillLevel": {
"enum": [
"beginner",
"intermediate",
"advanced",
"expert"
],
"type": "string"
},
"emailOnLogProcessed": {
"type": "boolean"
},
"chatVehicleFactsEnabled": {
"type": "boolean"
},
"freshLogSaveDestination": {
"enum": [
"vehicle_logs",
"workspace",
"analyzer",
"timeseries",
"scatter",
"heatmap",
"histogram",
"maps",
"statistics",
"health"
],
"type": "string"
},
"newVehicleSaveDestination": {
"enum": [
"vehicle_garage",
"view_vehicle",
"vehicle_logs",
"chassis_setups",
"driving_session"
],
"type": "string"
},
"supportChatBubbleVisibility": {
"enum": [
"show_always",
"desktop_only",
"hide_always"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update user preferences",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Update unit-category choices for the connected TuneWorks user. Load the authoritative write-options read tool for valid category/unit pairs.
| Parameter | Type | Description |
|---|---|---|
| settings * | array |
{
"name": "update_unit_settings",
"title": "Update unit settings",
"description": "Update unit-category choices for the connected TuneWorks user. Load the authoritative write-options read tool for valid category/unit pairs.",
"inputSchema": {
"type": "object",
"required": [
"settings"
],
"properties": {
"settings": {
"type": "array",
"items": {
"type": "object",
"required": [
"category",
"unit"
],
"properties": {
"unit": {
"type": "string",
"description": "Allowed unit for the selected category from the authoritative write-options read tool."
},
"category": {
"type": "string",
"description": "Category returned in unitSettings by the authoritative write-options read tool."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update unit settings",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Add a custom vehicle make to connected user settings.
| Parameter | Type | Description |
|---|---|---|
| make * | string | |
| teamId | string |
{
"name": "create_vehicle_make",
"title": "Create custom vehicle make",
"description": "Add a custom vehicle make to connected user settings.",
"inputSchema": {
"type": "object",
"required": [
"make"
],
"properties": {
"make": {
"type": "string"
},
"teamId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create custom vehicle make",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Rename or rescope a custom vehicle make.
| Parameter | Type | Description |
|---|---|---|
| id * | number | |
| make * | string | |
| teamId | string |
{
"name": "update_vehicle_make",
"title": "Update custom vehicle make",
"description": "Rename or rescope a custom vehicle make.",
"inputSchema": {
"type": "object",
"required": [
"id",
"make"
],
"properties": {
"id": {
"type": "number"
},
"make": {
"type": "string"
},
"teamId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update custom vehicle make",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Permanently delete a custom vehicle make after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| id * | number | |
| confirmed * | boolean |
{
"name": "delete_vehicle_make",
"title": "Delete custom vehicle make",
"description": "Permanently delete a custom vehicle make after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"id",
"confirmed"
],
"properties": {
"id": {
"type": "number"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Delete custom vehicle make",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List saved chart-channel sets.
No parameters.
{
"name": "list_chart_channel_sets",
"title": "List chart channel sets",
"description": "List saved chart-channel sets.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List chart channel sets",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Save a named set of chart channels.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| channels * | array |
{
"name": "create_chart_channel_set",
"title": "Save chart channel set",
"description": "Save a named set of chart channels.",
"inputSchema": {
"type": "object",
"required": [
"name",
"channels"
],
"properties": {
"name": {
"type": "string"
},
"channels": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Save chart channel set",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Update the last-used time for a saved chart-channel set.
| Parameter | Type | Description |
|---|---|---|
| id * | number |
{
"name": "mark_chart_channel_set_used",
"title": "Mark chart channel set used",
"description": "Update the last-used time for a saved chart-channel set.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "number"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Mark chart channel set used",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Permanently delete a saved chart-channel set after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| id * | number | |
| confirmed * | boolean |
{
"name": "delete_chart_channel_set",
"title": "Delete chart channel set",
"description": "Permanently delete a saved chart-channel set after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"id",
"confirmed"
],
"properties": {
"id": {
"type": "number"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Delete chart channel set",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List favorite charts for an accessible vehicle.
| Parameter | Type | Description |
|---|---|---|
| vehicleId * | string |
{
"name": "list_favorite_charts",
"title": "List favorite charts",
"description": "List favorite charts for an accessible vehicle.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List favorite charts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Save a favorite chart for an accessible vehicle and source log.
| Parameter | Type | Description |
|---|---|---|
| notes | string | |
| title * | string | |
| source | string | one of ["analyzer","charts"] |
| vehicleId * | string | |
| chartConfig * | object | |
| sourceLogId * | string | |
| channelSetId | number |
{
"name": "create_favorite_chart",
"title": "Create favorite chart",
"description": "Save a favorite chart for an accessible vehicle and source log.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"sourceLogId",
"title",
"chartConfig"
],
"properties": {
"notes": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"enum": [
"analyzer",
"charts"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"chartConfig": {
"type": "object",
"additionalProperties": true
},
"sourceLogId": {
"type": "string"
},
"channelSetId": {
"type": "number"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create favorite chart",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Permanently delete a favorite chart after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| chartId * | number | |
| confirmed * | boolean |
{
"name": "delete_favorite_chart",
"title": "Delete favorite chart",
"description": "Permanently delete a favorite chart after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"chartId",
"confirmed"
],
"properties": {
"chartId": {
"type": "number"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Delete favorite chart",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Read the saved map-channel configuration for an accessible vehicle.
| Parameter | Type | Description |
|---|---|---|
| vehicleId * | string |
{
"name": "get_vehicle_map_config",
"title": "Get vehicle map config",
"description": "Read the saved map-channel configuration for an accessible vehicle.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Get vehicle map config",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Create or replace the connected user’s complete map-channel configuration.
| Parameter | Type | Description |
|---|---|---|
| signs | object | |
| lapType * | string | one of ["single","multiple"] |
| channels * | object | |
| vehicleId * | string | |
| selections * | object |
{
"name": "save_vehicle_map_config",
"title": "Save vehicle map config",
"description": "Create or replace the connected user’s complete map-channel configuration.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"lapType",
"selections",
"channels"
],
"properties": {
"signs": {
"type": "object",
"additionalProperties": true
},
"lapType": {
"enum": [
"single",
"multiple"
],
"type": "string"
},
"channels": {
"type": "object",
"additionalProperties": true
},
"vehicleId": {
"type": "string"
},
"selections": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Save vehicle map config",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Record completed maintenance in vehicle history and advance its tracker.
| Parameter | Type | Description |
|---|---|---|
| cost | number | |
| notes | string | |
| mileage | number | |
| logCount | number | |
| partsUsed | string | |
| trackerId * | string | |
| vehicleId * | string | |
| eventCount | number | |
| completedAt * | string | |
| engineHours | number | |
| nextDueDate | string | |
| nextDueMileage | number |
{
"name": "complete_maintenance",
"title": "Complete maintenance",
"description": "Record completed maintenance in vehicle history and advance its tracker.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"trackerId",
"completedAt"
],
"properties": {
"cost": {
"type": "number"
},
"notes": {
"type": "string"
},
"mileage": {
"type": "number"
},
"logCount": {
"type": "number"
},
"partsUsed": {
"type": "string"
},
"trackerId": {
"type": "string"
},
"vehicleId": {
"type": "string"
},
"eventCount": {
"type": "number"
},
"completedAt": {
"type": "string"
},
"engineHours": {
"type": "number"
},
"nextDueDate": {
"type": "string"
},
"nextDueMileage": {
"type": "number"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Complete maintenance",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List ECU-file metadata, optionally scoped to an accessible TuneWorks vehicle. Supplying vehicleId enables vehicle-specific recovery guidance. Binary contents are never returned.
| Parameter | Type | Description |
|---|---|---|
| vehicleId | string | Optional stable TuneWorks vehicle ID from an authorized garage response. |
{
"name": "list_ecu_files",
"title": "List ECU-file metadata",
"description": "List ECU-file metadata, optionally scoped to an accessible TuneWorks vehicle. Supplying vehicleId enables vehicle-specific recovery guidance. Binary contents are never returned.",
"inputSchema": {
"type": "object",
"properties": {
"vehicleId": {
"type": "string",
"description": "Optional stable TuneWorks vehicle ID from an authorized garage response."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "Authenticated ECU-file metadata or an actionable garage/data activation state.",
"additionalProperties": true
},
"annotations": {
"title": "List ECU-file metadata",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Inspect one authorized ECU file and optionally a decoded table. Binary contents are never returned.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| table | string |
{
"name": "inspect_ecu_file",
"title": "Inspect ECU-file metadata",
"description": "Inspect one authorized ECU file and optionally a decoded table. Binary contents are never returned.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"table": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Inspect ECU-file metadata",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Start or retry processing for an existing ECU definition file. This does not upload, create, or read a file, and processing may consume compute and analysis resources.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "process_ecu_file",
"title": "Process ECU file",
"description": "Start or retry processing for an existing ECU definition file. This does not upload, create, or read a file, and processing may consume compute and analysis resources.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Process ECU file",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Retry an eligible failed, already stored ECU file. MCP does not upload binaries.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "retry_ecu_file",
"title": "Retry ECU file",
"description": "Retry an eligible failed, already stored ECU file. MCP does not upload binaries.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Retry ECU file",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Permanently delete an authorized ECU file after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| confirmed * | boolean |
{
"name": "delete_ecu_file",
"title": "Delete ECU file",
"description": "Permanently delete an authorized ECU file after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"id",
"confirmed"
],
"properties": {
"id": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Delete ECU file",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Emails selected TuneWorks vehicle, setup, and session details to up to three recipients. Explicit user confirmation is required.
| Parameter | Type | Description |
|---|---|---|
| message | string | Optional message to include in the Share Build email. |
| setupIds | array | Optional TuneWorks setup IDs to include. |
| confirmed * | boolean | True indicates that the user explicitly confirmed the recipient list and selected build details. |
| vehicleId * | string | TuneWorks vehicle ID selected for Share Build. |
| recipients * | array | Recipient email addresses. Share Build supports up to 3 recipients. |
| sessionIds | array | Optional TuneWorks session IDs to include. |
{
"name": "send_share_build",
"title": "Send Share Build",
"description": "Emails selected TuneWorks vehicle, setup, and session details to up to three recipients. Explicit user confirmation is required.",
"inputSchema": {
"type": "object",
"required": [
"vehicleId",
"recipients",
"confirmed"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000,
"description": "Optional message to include in the Share Build email."
},
"setupIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional TuneWorks setup IDs to include."
},
"confirmed": {
"type": "boolean",
"description": "True indicates that the user explicitly confirmed the recipient list and selected build details."
},
"vehicleId": {
"type": "string",
"description": "TuneWorks vehicle ID selected for Share Build."
},
"recipients": {
"type": "array",
"items": {
"type": "string",
"format": "email"
},
"maxItems": 3,
"minItems": 1,
"description": "Recipient email addresses. Share Build supports up to 3 recipients."
},
"sessionIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional TuneWorks session IDs to include."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"id": {
"type": "string"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"actionType": {
"type": "string"
},
"previewTool": {
"type": "string"
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
}
},
"description": "Share Build send result or confirmation-required response for the external email action.",
"additionalProperties": true
},
"annotations": {
"title": "Send Share Build",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}List teams available to the connected user, or read one team’s settings.
| Parameter | Type | Description |
|---|---|---|
| teamId | string |
{
"name": "list_teams",
"title": "List teams",
"description": "List teams available to the connected user, or read one team’s settings.",
"inputSchema": {
"type": "object",
"properties": {
"teamId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List teams",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Create a new team for the connected user.
| Parameter | Type | Description |
|---|---|---|
| name * | string |
{
"name": "create_team",
"title": "Create team",
"description": "Create a new team for the connected user.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create team",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Replace a team’s name.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| teamId * | string |
{
"name": "rename_team",
"title": "Rename team",
"description": "Replace a team’s name.",
"inputSchema": {
"type": "object",
"required": [
"teamId",
"name"
],
"properties": {
"name": {
"type": "string"
},
"teamId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Rename team",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Replace a team member’s role.
| Parameter | Type | Description |
|---|---|---|
| role * | string | one of ["owner","editor","viewer"] |
| teamId * | string | |
| userId * | number |
{
"name": "update_team_member_role",
"title": "Update team member role",
"description": "Replace a team member’s role.",
"inputSchema": {
"type": "object",
"required": [
"teamId",
"userId",
"role"
],
"properties": {
"role": {
"enum": [
"owner",
"editor",
"viewer"
],
"type": "string"
},
"teamId": {
"type": "string"
},
"userId": {
"type": "number"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update team member role",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Remove a member from a team after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| teamId * | string | |
| userId * | number | |
| confirmed * | boolean |
{
"name": "remove_team_member",
"title": "Remove team member",
"description": "Remove a member from a team after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"teamId",
"userId",
"confirmed"
],
"properties": {
"teamId": {
"type": "string"
},
"userId": {
"type": "number"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Remove team member",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Revoke a pending team invitation after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| teamId * | string | |
| inviteId * | string | |
| confirmed * | boolean |
{
"name": "revoke_team_invite",
"title": "Revoke team invite",
"description": "Revoke a pending team invitation after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"teamId",
"inviteId",
"confirmed"
],
"properties": {
"teamId": {
"type": "string"
},
"inviteId": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Revoke team invite",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Remove the connected user from a team after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| teamId * | string | |
| confirmed * | boolean |
{
"name": "leave_team",
"title": "Leave team",
"description": "Remove the connected user from a team after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"teamId",
"confirmed"
],
"properties": {
"teamId": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Leave team",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Delete a team after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| teamId * | string | |
| confirmed * | boolean |
{
"name": "delete_team",
"title": "Delete team",
"description": "Delete a team after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"teamId",
"confirmed"
],
"properties": {
"teamId": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Delete team",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Create and email a team invitation only after explicit user confirmation.
| Parameter | Type | Description |
|---|---|---|
| role * | string | one of ["editor","viewer"] |
| email * | string | |
| teamId * | string | |
| confirmed * | boolean |
{
"name": "send_team_invite",
"title": "Send team invite",
"description": "Create and email a team invitation only after explicit user confirmation.",
"inputSchema": {
"type": "object",
"required": [
"teamId",
"email",
"role",
"confirmed"
],
"properties": {
"role": {
"enum": [
"editor",
"viewer"
],
"type": "string"
},
"email": {
"type": "string",
"format": "email"
},
"teamId": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Send team invite",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}List custom tracks accessible to the connected user.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query | string |
{
"name": "list_custom_tracks",
"title": "List custom tracks",
"description": "List custom tracks accessible to the connected user.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List custom tracks",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one accessible custom track.
| Parameter | Type | Description |
|---|---|---|
| trackId * | string |
{
"name": "get_custom_track",
"title": "Get custom track",
"description": "Read one accessible custom track.",
"inputSchema": {
"type": "object",
"required": [
"trackId"
],
"properties": {
"trackId": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Get custom track",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Create a custom track for the connected user or an editable team.
| Parameter | Type | Description |
|---|---|---|
| city | string | |
| venue * | string | |
| region | string | |
| teamId | string | |
| country | string | |
| countryCode | string |
{
"name": "create_custom_track",
"title": "Create custom track",
"description": "Create a custom track for the connected user or an editable team.",
"inputSchema": {
"type": "object",
"required": [
"venue"
],
"properties": {
"city": {
"type": "string"
},
"venue": {
"type": "string"
},
"region": {
"type": "string"
},
"teamId": {
"type": "string"
},
"country": {
"type": "string"
},
"countryCode": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Create custom track",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Replace the editable fields and ownership scope of a custom track.
| Parameter | Type | Description |
|---|---|---|
| city | string | |
| venue * | string | |
| region | string | |
| teamId | string | |
| country | string | |
| trackId * | string | |
| countryCode | string |
{
"name": "update_custom_track",
"title": "Update custom track",
"description": "Replace the editable fields and ownership scope of a custom track.",
"inputSchema": {
"type": "object",
"required": [
"trackId",
"venue"
],
"properties": {
"city": {
"type": "string"
},
"venue": {
"type": "string"
},
"region": {
"type": "string"
},
"teamId": {
"type": "string"
},
"country": {
"type": "string"
},
"trackId": {
"type": "string"
},
"countryCode": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"url": {
"type": "string"
},
"list": {
"type": "object"
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"setup": {
"type": "object"
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"session": {
"type": "object"
},
"tracker": {
"type": "object"
},
"vehicle": {
"type": "object"
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modification": {
"type": "object"
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"onboardingTransition": {
"enum": [
"build_context_recorded",
"baseline_setup_recorded",
"driving_session_recorded"
],
"type": "string"
}
},
"description": "TuneWorks app object create/update result with the saved object, connected user, and next activation actions.",
"additionalProperties": true
},
"annotations": {
"title": "Update custom track",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Permanently delete a custom track after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| trackId * | string | |
| confirmed * | boolean |
{
"name": "delete_custom_track",
"title": "Delete custom track",
"description": "Permanently delete a custom track after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"trackId",
"confirmed"
],
"properties": {
"trackId": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Delete custom track",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List attachment metadata for an authorized object. Binary contents are unavailable through MCP.
| Parameter | Type | Description |
|---|---|---|
| objectId * | string | |
| objectType * | string | one of ["vehicle","setup","session","log","vehicle_mod"] |
{
"name": "list_object_attachments",
"title": "List object attachments",
"description": "List attachment metadata for an authorized object. Binary contents are unavailable through MCP.",
"inputSchema": {
"type": "object",
"required": [
"objectType",
"objectId"
],
"properties": {
"objectId": {
"type": "string"
},
"objectType": {
"enum": [
"vehicle",
"setup",
"session",
"log",
"vehicle_mod"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "List object attachments",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Delete an object attachment from blob storage after explicit confirmation.
| Parameter | Type | Description |
|---|---|---|
| fileId * | string | |
| confirmed * | boolean |
{
"name": "delete_object_attachment",
"title": "Delete object attachment",
"description": "Delete an object attachment from blob storage after explicit confirmation.",
"inputSchema": {
"type": "object",
"required": [
"fileId",
"confirmed"
],
"properties": {
"fileId": {
"type": "string"
},
"confirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status",
"tool"
],
"properties": {
"logs": {
"type": "array",
"items": {
"type": "object"
}
},
"tool": {
"type": "string",
"description": "TuneWorks MCP tool name that produced this result."
},
"user": {
"type": "object"
},
"count": {
"type": "number"
},
"lists": {
"type": "array",
"items": {
"type": "object"
}
},
"setups": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"description": "Stable result status such as ok, created, updated, sent, auth_required, or confirmation_required."
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"no_vehicles",
"vehicle_not_found",
"vehicle_selection_required",
"no_data"
],
"type": "string",
"description": "Optional domain outcome for an otherwise successful read."
},
"sessions": {
"type": "array",
"items": {
"type": "object"
}
},
"vehicles": {
"type": "array",
"items": {
"type": "object"
}
},
"snapshots": {
"type": "array",
"items": {
"type": "object"
}
},
"activation": {
"type": "object",
"required": [
"goal",
"stage",
"missingData",
"recommendedData",
"nextActions"
],
"properties": {
"goal": {
"type": "string",
"const": "optimize_vehicle"
},
"stage": {
"enum": [
"empty_garage",
"select_vehicle",
"vehicle_selected",
"vehicle_created",
"collecting_baseline_data",
"ready_to_optimize"
],
"type": "string"
},
"vehicleId": {
"type": "string"
},
"missingData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"nextActions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"tool",
"reason"
],
"properties": {
"tool": {
"enum": [
"create_vehicle",
"list_vehicles",
"get_vehicle_context",
"create_setup",
"create_session",
"update_vehicle",
"create_vehicle_modification"
],
"type": "string"
},
"type": {
"type": "string",
"const": "tool"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
},
"arguments": {
"type": "object",
"required": [
"vehicleId"
],
"properties": {
"vehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"requiredInputs": {
"type": "array",
"items": {
"enum": [
"year",
"make",
"model",
"purpose",
"displacement",
"engineType",
"aspiration",
"cylindersOrRotors",
"fuel",
"fuelRating",
"setupName",
"setupDate",
"sessionDate",
"sessionFormat",
"modifications",
"category",
"system",
"status",
"brand",
"partName"
],
"type": "string"
},
"uniqueItems": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"reason"
],
"properties": {
"type": {
"type": "string",
"const": "assistant"
},
"action": {
"enum": [
"select_vehicle",
"capture_vehicle_build_state",
"capture_baseline_setup",
"capture_driving_feedback"
],
"type": "string"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"action",
"url",
"reason"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"const": "website"
},
"action": {
"type": "string",
"const": "open_race_engineer"
},
"reason": {
"type": "string"
},
"optional": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
}
},
"recommendedData": {
"type": "array",
"items": {
"enum": [
"vehicle",
"accessible_vehicle_id",
"baseline_setup",
"driving_session",
"vehicle_build_state",
"vehicle_logs",
"structured_vehicle_modifications"
],
"type": "string"
},
"uniqueItems": true
},
"requestedVehicleId": {
"type": "string"
}
},
"additionalProperties": false
},
"maintenance": {
"type": "array",
"items": {
"type": "object"
}
},
"billingLimit": {
"type": "object",
"required": [
"metric",
"used",
"limit",
"planName"
],
"properties": {
"used": {
"type": "number"
},
"limit": {
"type": "number"
},
"metric": {
"type": "string"
},
"planName": {
"type": "string"
}
},
"description": "Plan usage limit that blocked the requested MCP action.",
"additionalProperties": false
},
"modifications": {
"type": "array",
"items": {
"type": "object"
}
},
"websiteHandoff": {
"type": "object",
"required": [
"capability",
"title",
"reason",
"url",
"cta",
"required",
"requiresAuthentication"
],
"properties": {
"cta": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean",
"const": true
},
"capability": {
"enum": [
"ai_copilot",
"ai_race_engineer",
"ai_log_analyzer",
"telemetry_upload",
"haltech_ecu_recovery",
"object_file_upload",
"interactive_log_analysis",
"log_comparison",
"setup_comparison",
"account_security",
"api_keys",
"pc_uploader",
"pwa_install",
"team_invitation",
"billing_management"
],
"type": "string"
},
"requiresAuthentication": {
"type": "boolean"
}
},
"description": "Required website destination for a workflow intentionally kept outside MCP.",
"additionalProperties": false
},
"requestedVehicleId": {
"type": "string"
}
},
"description": "TuneWorks app object list result with connected user, count, and matching records.",
"additionalProperties": true
},
"annotations": {
"title": "Delete object attachment",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}TuneWorks MCP has two tiers. Without authentication, it exposes public free tools for handling diagnosis, tire temperatures, dampers, ethanol blends, gearing, tire pressure, corner balance, wheel rates, injector sizing, AFR/lambda conversion, brake bias, tire sizes, alignment, and lap deltas. Read tools/list for exact input units and required fields; ask for missing measurements rather than inventing defaults. Successful public results include an optional garageContinuation for users who want to continue from the result and build toward optimization. Autocross Site Finder is available through find_autocross_sites. Haltech ECU recovery remains website-only because MCP lacks the bounded binary upload/download transport needed to preserve its authorization and file-safety controls. TuneWorks Copilot, Race Engineer, AI Log Analyzer, file transfer, rich interactive telemetry visualization, account/security, installation, invitation acceptance, setup comparison, and billing management are also hard website boundaries. Use get_tuneworks_website_handoff instead of guessing URLs or emulating those workflows; billing handoffs are only for explicit user requests. With authentication, start with get_garage_summary and follow its single prioritized next action through vehicle creation, build context, baseline setup, driving-session feedback, and the required Race Engineer website handoff. /app/admin, billing administration, checkout, arbitrary SQL, raw database access, hard deletes, and user impersonation are not available. Sending Share Build is an external email action and requires explicit user confirmation.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.