-
Notifications
You must be signed in to change notification settings - Fork 19
Tool Reference
35 tools: 30 predefined queries, 2 built-ins, and 3 MCP Apps chart tools. A 36th appears when write tools are enabled.
Every predefined tool accepts optional filters — car_name (case-insensitive substring match) almost everywhere, plus days windows, limit caps, and per-tool thresholds where they make sense. Calling a tool with no arguments returns the full classic report, so nothing you already had breaks.
Run teslamate-mcp list-tools to print the live list with each tool's parameters.
| Tool | Parameters | Returns |
|---|---|---|
get_basic_car_information |
car_name |
Model, trim, colour, marketing name, supercharging status |
get_current_car_status |
car_name |
Latest position: battery level, range, odometer, outside temperature, climate state, nearest address |
get_software_update_history |
car_name |
Every firmware version with install dates |
| Tool | Parameters | Returns |
|---|---|---|
get_battery_health_summary |
car_name |
Latest snapshot: battery level, rated/ideal/estimated range, health percentage |
get_battery_degradation_over_time |
car_name, days
|
Monthly rated-range trend |
get_battery_capacity_trend |
car_name, days, min_soc_delta
|
Usable capacity in kWh estimated from charging sessions (energy added ÷ SOC gained). A real energy-based degradation signal rather than a rated-range heuristic |
get_daily_battery_usage_patterns |
car_name, days, min_swing_pct
|
Daily SOC swing, highs and lows |
get_soc_hygiene |
car_name, days
|
Share of samples above 80% and below 20% SOC — battery-care habits |
get_tire_pressure_weekly_trends |
car_name, days
|
Weekly average pressure per corner |
| Tool | Parameters | Returns |
|---|---|---|
get_monthly_driving_summary |
car_name, days
|
Distance, duration, and efficiency per month |
get_daily_driving_patterns |
car_name, days
|
Distance by day of week |
get_drive_summary_per_day |
car_name, days, limit
|
One row per day with totals |
get_longest_drives_by_distance |
car_name, days, min_distance_km, limit
|
Longest drives with start/end locations |
get_total_distance_and_efficiency |
car_name, days
|
Lifetime (or windowed) distance, energy, and Wh/km |
get_period_comparison |
car_name, days
|
Last N days vs the N days before, one row per metric, with percent change |
| Tool | Parameters | Returns |
|---|---|---|
get_efficiency_by_month_and_temperature |
car_name, days
|
Efficiency cross-tabbed with outside temperature |
get_average_efficiency_by_temperature |
car_name, days
|
Wh/km bucketed by temperature band |
get_unusual_power_consumption |
car_name, days, threshold_pct, limit
|
Drives whose consumption deviates most from the norm |
| Tool | Parameters | Returns |
|---|---|---|
get_all_charging_sessions_summary |
car_name, days
|
Session count, total energy, total cost |
get_charging_by_location |
car_name, days, limit
|
Energy and sessions grouped by address |
get_charging_by_geofence |
car_name, days
|
Totals per TeslaMate geofence (Home/Work/…) plus an "Ungeofenced" bucket |
get_charging_efficiency |
car_name, days
|
kWh added vs kWh drawn, split AC and DC |
get_charging_costs |
group_by, car_name, start_date, end_date
|
Cost breakdown grouped by month, location, or car |
get_vampire_drain |
car_name, days, min_gap_hours, limit
|
Rated range lost while parked between drives, excluding gaps containing a charge |
| Tool | Parameters | Returns |
|---|---|---|
get_most_visited_locations |
car_name, days, limit
|
Addresses ranked by visit count |
Use the search tools to find an id, then the detail tools to drill in.
| Tool | Parameters | Returns |
|---|---|---|
search_drives |
car_name, start_date, end_date, min_distance_km, max_distance_km, location, limit, order_by
|
Matching drives with ids |
search_charging_sessions |
car_name, start_date, end_date, location, min_energy_kwh, limit
|
Matching sessions with ids |
get_drive_details |
drive_id |
Full statistics for one drive |
get_drive_route |
drive_id, max_points
|
Downsampled GPS track points |
get_charging_curve |
charging_process_id, max_points
|
Downsampled power and SOC curve |
Interactive counterparts of three query tools. On Apps-capable clients they render a self-contained chart inline in the conversation; everywhere else they return exactly the same rows as their backing query.
| Tool | Backing query | Chart |
|---|---|---|
show_charging_curve |
get_charging_curve |
Power and SOC against time |
show_battery_degradation |
get_battery_degradation_over_time |
Multi-car monthly trend with per-car deltas |
show_drive_route |
get_drive_route |
Pure-SVG route map with start/end markers and a scale bar |
| Tool | Parameters | Returns |
|---|---|---|
get_database_schema |
table, refresh
|
Compact table list, full column detail for one table, or a forced re-read after DDL changes |
run_sql |
query |
Executes a custom SELECT or WITH … SELECT
|
run_sql runs inside a PostgreSQL READ ONLY transaction that is always rolled back, with statement_timeout, lock_timeout, and an automatic row cap. Even SQL that gets past the Python-side checks cannot modify the database.
Six one-click workflows: battery health, driving summary, charging behaviour, anomaly hunting, weather efficiency, and a quick status report. Enabling write tools adds a seventh, backfill_costs_from_receipts.
-
teslamate://queries— the catalog of predefined queries -
teslamate://queries/{name}— one query's metadata and SQL -
ui://resources backing each MCP App