cOBD
Your car's drives, fuel use and engine health from its OBD-II port. Explains any fault code.
Should I use this
Quality & Safety
Findings (5)
- LOWin explain_fault_code
- LOWin get_fault_codes
- LOWin get_fuel
- LOWin get_health_score
- LOWin get_drive_score
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"cobd": {
"url": "https://cobd.app/mcp"
}
}
}Remote endpoints
https://cobd.app/mcpstreamable-httpWhat it can do
Tool inventory
Tools (13)
🟢explain_fault_code(code)
What an OBD-II fault code means, how serious it is, common causes and what to do. Example: P0420.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "A fault code such as P0420"
}
},
"required": [
"code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"title": {
"type": "string"
},
"system": {
"type": "string"
},
"severity": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"causes": {
"type": "array",
"items": {
"type": "string"
}
},
"advice": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"code",
"title",
"system",
"severity"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢search_fault_codes(query, limit)
Find fault codes by the words in their name, such as "misfire cylinder 3", or look up one code.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"description": "A few words or a code"
},
"limit": {
"description": "How many to return, 1 to 25. Default 10.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"code",
"title"
],
"additionalProperties": false
}
}
},
"required": [
"results"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢about_cobd
What cOBD is, what it needs, the Free and Pro plans and where to start.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"summary": {
"type": "string"
},
"needs": {
"type": "string"
},
"plans": {
"type": "object",
"properties": {
"free": {
"type": "array",
"items": {
"type": "string"
}
},
"pro": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"free",
"pro"
],
"additionalProperties": false
},
"links": {
"type": "object",
"properties": {
"start": {
"type": "string"
},
"setup": {
"type": "string"
},
"privacy": {
"type": "string"
},
"mcp": {
"type": "string"
}
},
"required": [
"start",
"setup",
"privacy",
"mcp"
],
"additionalProperties": false
}
},
"required": [
"name",
"summary",
"needs",
"plans",
"links"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_news(limit)
The latest public posts, newest first.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "How many to return, 1 to 25. Default 10.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"posts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"date": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"title",
"date",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"posts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢read_news(slug)
The text of one public post. Use a slug from list_news.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The post's slug"
}
},
"required": [
"slug"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"title": {
"type": "string"
},
"date": {
"type": "string"
},
"url": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"title",
"date",
"url",
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_cars
The driver's cars with their ids and last drive, and the driver's plan.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"plan": {
"type": "string",
"enum": [
"free",
"pro"
]
},
"units": {
"type": "string",
"enum": [
"metric",
"us",
"uk"
]
},
"cars": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"make": {
"type": [
"string",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
},
"last_drive": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"make",
"model",
"year",
"last_drive"
],
"additionalProperties": false
}
}
},
"required": [
"plan",
"units",
"cars"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_car_status(car_id)
The latest readings from one car, such as engine speed, coolant, fuel level and battery, and its check-engine state.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"description": "A car id from list_cars. Without it, the car driven last.",
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 20
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"car": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"units": {
"type": "string",
"enum": [
"metric",
"us",
"uk"
]
},
"time": {
"type": [
"string",
"null"
]
},
"age_minutes": {
"type": [
"number",
"null"
]
},
"readings": {
"anyOf": [
{
"type": "object",
"properties": {
"rpm": {
"type": [
"number",
"null"
]
},
"speed_kph": {
"type": [
"number",
"null"
]
},
"coolant_c": {
"type": [
"number",
"null"
]
},
"throttle_pct": {
"type": [
"number",
"null"
]
},
"fuel_pct": {
"type": [
"number",
"null"
]
},
"range_km": {
"type": [
"number",
"null"
]
},
"battery_v": {
"type": [
"number",
"null"
]
},
"intake_c": {
"type": [
"number",
"null"
]
},
"load_pct": {
"type": [
"number",
"null"
]
}
},
"required": [
"rpm",
"speed_kph",
"coolant_c",
"throttle_pct",
"fuel_pct",
"range_km",
"battery_v",
"intake_c",
"load_pct"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"fault_lamp": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"codes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"codes"
],
"additionalProperties": false
}
},
"required": [
"car",
"units",
"time",
"age_minutes",
"readings",
"fault_lamp"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_fault_codes(car_id)
The fault codes one car reported, whether each is still active, and what it means.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"description": "A car id from list_cars. Without it, the car driven last.",
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 20
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"car": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"units": {
"type": "string",
"enum": [
"metric",
"us",
"uk"
]
},
"status": {
"type": "string"
},
"headline": {
"type": "string"
},
"codes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"active": {
"type": "boolean"
},
"first_reported": {
"type": "string"
},
"last_reported": {
"type": "string"
},
"reports": {
"type": "number"
},
"severity": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"causes": {
"type": "array",
"items": {
"type": "string"
}
},
"advice": {
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"title",
"status",
"active",
"first_reported",
"last_reported",
"reports",
"severity",
"summary",
"causes",
"advice"
],
"additionalProperties": false
}
},
"disclaimer": {
"type": "string"
}
},
"required": [
"car",
"units",
"status",
"headline",
"codes",
"disclaimer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_drives(car_id, from, to, limit)
One car's drives, newest first, with distance, time, speed, fuel used and weather.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"description": "A car id from list_cars. Without it, the car driven last.",
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 20
}
]
},
"from": {
"description": "Drives from this day, such as 2026-03-01, or an ISO time with Z or an offset",
"type": "string",
"maxLength": 40
},
"to": {
"description": "Drives up to the end of this day, or up to an ISO time with Z or an offset",
"type": "string",
"maxLength": 40
},
"limit": {
"description": "How many to return, 1 to 50. Default 10.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"car": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"units": {
"type": "string",
"enum": [
"metric",
"us",
"uk"
]
},
"drives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"start": {
"type": "string"
},
"end": {
"type": "string"
},
"distance_km": {
"type": [
"number",
"null"
]
},
"duration_min": {
"type": [
"number",
"null"
]
},
"avg_speed_kph": {
"type": [
"number",
"null"
]
},
"max_speed_kph": {
"type": [
"number",
"null"
]
},
"fuel_used_l": {
"type": [
"number",
"null"
]
},
"economy_kpl": {
"type": [
"number",
"null"
]
},
"weather": {
"type": [
"string",
"null"
]
}
},
"required": [
"start",
"end",
"distance_km",
"duration_min",
"avg_speed_kph",
"max_speed_kph",
"fuel_used_l",
"economy_kpl",
"weather"
],
"additionalProperties": false
}
}
},
"required": [
"car",
"units",
"drives"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_fuel(car_id, days)
One car's fuel level and range, and its fuel economy over recent days.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"description": "A car id from list_cars. Without it, the car driven last.",
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 20
}
]
},
"days": {
"description": "Days of driving for the economy, 1 to 365. Default 30.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"car": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"units": {
"type": "string",
"enum": [
"metric",
"us",
"uk"
]
},
"latest": {
"type": "object",
"properties": {
"level_pct": {
"type": [
"number",
"null"
]
},
"range_km": {
"type": [
"number",
"null"
]
}
},
"required": [
"level_pct",
"range_km"
],
"additionalProperties": false
},
"economy": {
"anyOf": [
{
"type": "object",
"properties": {
"days": {
"type": "number"
},
"distance_km": {
"type": "number"
},
"fuel_l": {
"type": "number"
},
"kpl": {
"type": "number"
},
"l_per_100km": {
"type": "number"
}
},
"required": [
"days",
"distance_km",
"fuel_l",
"kpl",
"l_per_100km"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"car",
"units",
"latest",
"economy"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_health_score(car_id)
One car's engine health score from 0 to 100, part by part. Pro plan.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"description": "A car id from list_cars. Without it, the car driven last.",
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 20
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"units": {
"type": "string",
"enum": [
"metric",
"us",
"uk"
]
},
"car": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"score": {
"type": [
"number",
"null"
]
},
"components": {
"type": "object",
"properties": {
"faults": {
"type": "object",
"properties": {
"score": {
"type": [
"number",
"null"
]
},
"max": {
"type": "number"
},
"label": {
"type": "string"
},
"detail": {
"type": [
"string",
"null"
]
},
"available": {
"type": "boolean"
}
},
"required": [
"score",
"max",
"label",
"detail",
"available"
],
"additionalProperties": false
},
"coolant": {
"type": "object",
"properties": {
"score": {
"type": [
"number",
"null"
]
},
"max": {
"type": "number"
},
"label": {
"type": "string"
},
"detail": {
"type": [
"string",
"null"
]
},
"available": {
"type": "boolean"
}
},
"required": [
"score",
"max",
"label",
"detail",
"available"
],
"additionalProperties": false
},
"fuelTrim": {
"type": "object",
"properties": {
"score": {
"type": [
"number",
"null"
]
},
"max": {
"type": "number"
},
"label": {
"type": "string"
},
"detail": {
"type": [
"string",
"null"
]
},
"available": {
"type": "boolean"
}
},
"required": [
"score",
"max",
"label",
"detail",
"available"
],
"additionalProperties": false
},
"o2": {
"type": "object",
"properties": {
"score": {
"type": [
"number",
"null"
]
},
"max": {
"type": "number"
},
"label": {
"type": "string"
},
"detail": {
"type": [
"string",
"null"
]
},
"available": {
"type": "boolean"
}
},
"required": [
"score",
"max",
"label",
"detail",
"available"
],
"additionalProperties": false
},
"battery": {
"type": "object",
"properties": {
"score": {
"type": [
"number",
"null"
]
},
"max": {
"type": "number"
},
"label": {
"type": "string"
},
"detail": {
"type": [
"string",
"null"
]
},
"available": {
"type": "boolean"
}
},
"required": [
"score",
"max",
"label",
"detail",
"available"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"pro_required": {
"type": "boolean",
"const": true
},
"upgrade_url": {
"type": "string"
}
},
"required": [
"units"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_drive_score(car_id, days)
How smoothly one car was driven, from hard braking, acceleration and cornering. Pro plan.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"description": "A car id from list_cars. Without it, the car driven last.",
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 20
}
]
},
"days": {
"description": "Days of driving to score, 1 to 365. Default 30.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"units": {
"type": "string",
"enum": [
"metric",
"us",
"uk"
]
},
"car": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"days": {
"type": "number"
},
"score": {
"type": [
"number",
"null"
]
},
"grade": {
"type": [
"string",
"null"
]
},
"breakdown": {
"type": "object",
"properties": {
"readings": {
"type": [
"number",
"null"
]
},
"distance_km": {
"type": [
"number",
"null"
]
},
"hard_brakes": {
"type": [
"number",
"null"
]
},
"hard_accels": {
"type": [
"number",
"null"
]
},
"hard_corners": {
"type": [
"number",
"null"
]
},
"events_per_100km": {
"type": [
"number",
"null"
]
}
},
"required": [
"readings",
"distance_km",
"hard_brakes",
"hard_accels",
"hard_corners",
"events_per_100km"
],
"additionalProperties": false
},
"pro_required": {
"type": "boolean",
"const": true
},
"upgrade_url": {
"type": "string"
}
},
"required": [
"units"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_car_location(car_id)
Where one car was last, with a map link. The driver allows this separately.
Input Schema
{
"type": "object",
"properties": {
"car_id": {
"description": "A car id from list_cars. Without it, the car driven last.",
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"maxLength": 20
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"car": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"units": {
"type": "string",
"enum": [
"metric",
"us",
"uk"
]
},
"lat": {
"type": [
"number",
"null"
]
},
"lon": {
"type": [
"number",
"null"
]
},
"time": {
"type": [
"string",
"null"
]
},
"speed_kph": {
"type": [
"number",
"null"
]
},
"map_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"car",
"units",
"lat",
"lon",
"time",
"speed_kph",
"map_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence