Server version & diagnostic info — call first to confirm the build.

Returns the running server version, Python/fastmcp versions, timezone, tool count, and whether the TeslaMate database is reachable. Useful for support, debugging, and confirming you hit the expected deployment.

List all vehicles registered in TeslaMate.

Returns each car's ID, name, model, VIN, and efficiency. Use the car_id with other tools to query a specific vehicle.

Current vehicle state -- battery, range, location, climate, odometer.

Returns the latest position snapshot and vehicle info from TeslaMate.

Charging sessions over the last N days.

Shows energy added, duration, battery range, and location for each session.

Detailed charging sessions with location, energy, cost breakdown.

Unlike tesla_charging_history which summarizes by process, this returns granular charging session data.

Recent drives -- distance, duration, efficiency, start/end locations.

Shows driving activity with energy consumption.

Driving score based on acceleration, braking, and speed habits.

Get trips filtered by category.

Show count of trips by category for recent drives.

Battery degradation trend -- range at 100% charge over time.

Shows monthly snapshots of ideal range when battery is at 100%.

Energy consumption trends -- Wh/mi over time.

Shows weekly average efficiency from driving data.

Where the car has been -- top locations by time spent.

Groups positions by proximity and shows time at each cluster.

Vehicle state transitions -- online, asleep, offline.

Shows when the car was awake vs sleeping, useful for vampire drain analysis.

Firmware version history -- all recorded software versions and install dates.

Latest polled vehicle state from TeslaMate -- battery, climate, location.

Data comes from TeslaMate's positions table (polled periodically, not real-time). Fields like sentry mode, lock status, and media are not available in TeslaMate and are omitted.

Gas savings scorecard -- how much you've saved vs a gas car.

Estimate trip cost to a destination -- kWh, cost, range check.

Uses your personal 30-day average efficiency and current battery level. If QWeather is configured, the current weather at the origin and the destination is shown for reference only — it does NOT change the energy or cost estimate.

Current weather at the car's location (via QWeather 和风天气).

Uses the vehicle's latest GPS position to fetch real-time weather — temperature, feels-like, humidity, wind, precipitation, visibility, conditions. Complements TeslaMate's single outside_temp sensor.

Requires QWEATHER_API_KEY + QWEATHER_API_HOST env vars; otherwise returns a friendly hint and changes nothing else.

Efficiency curve by temperature -- Wh/mi at different temps.

Shows how outside temperature affects energy consumption.

Efficiency grouped by weather condition (via QWeather historical data).

Unlike tesla_efficiency_by_temp (which only buckets by outside_temp), this back-fills each drive's actual weather (clear/rain/snow/fog/wind) from QWeather's historical API and shows how conditions — not just temperature — affect consumption. Same 5°C day can differ hugely: dry-clear vs rain/snow.

Method (no database writes):

1. Pull recent drives with start/end coords, time, and ideal-range delta.

2. For each drive use its midpoint coordinate + mid-time to resolve a QWeather LocationID (cached) then daily historical weather (cached).

3. Bucket the drive by weather and aggregate kWh / distance per bucket.

To stay within API limits only the most recent drives are sampled (TESLA_WEATHER_SAMPLE_MAX, default 60). Requires QWEATHER_API_KEY + QWEATHER_API_HOST; otherwise returns a friendly hint.

Charging sessions grouped by location.

Most visited locations ranked by number of visits.

Top drives ranked by distance -- your epic road trips.

Monthly driving report with stats and comparison to previous month.

Current TPMS pressures with warnings for anomalies.

Reads from the latest position record in TeslaMate. Warns if any tyre is below TESLA_TPMS_MIN_THRESHOLD or above TESLA_TPMS_MAX_THRESHOLD, or differs from the average by > 0.15 bar.

Recent TPMS pressure history from TeslaMate.

Shows the average and min/max pressures recorded in positions table. Note: TeslaMate only stores positions during drives/charging, not while parked.

Monthly driving summary -- splits energy into three independent categories:

• Drive kWh -- estimated from drive range-drop (行驶能耗)

• Charge kWh -- energy added during charging sessions (充电能耗)

• Vampire kWh -- parked drain between drive_end and next event (停车耗电)

Wh/km uses ONLY driving kWh so efficiency is not contaminated by charging losses or vampire drain. The three categories are summed independently from their respective primary sources and never mixed in calculations.

Vampire drain analysis -- battery loss while parked overnight.

Checks for periods where the car was parked (no drives) for 8+ hours and measures battery drop. A parked period is tagged "露营模式" when the AVERAGE drain rate over the parked period is ≥ TESLA_CAMPING_KWH_PER_HOUR (default 0.8 kWh/h). The kWh conversion uses a fixed 75 kWh reference battery — so the threshold does NOT change whether the car is 75 / 82 / 100 kWh. Sentry and third-party-app activity are NOT distinguished from camping use: any aggregate drain rate at or above the threshold is flagged. If QWeather is configured, the current weather at the parking location is shown for the worst few events AND every camping-mode event (display-only).

Calculate eco savings and carbon reduction compared to an ICEV (燃油汽车).

Compares Tesla's actual electricity costs against a hypothetical ICEV consuming the same distance in fuel, plus CO2 savings and tree equivalents.

Generate a travel narrative timeline for LLM-powered travel blogging.

Extracts structured drive and stop data within a time window for generating travel narratives or Vlog scripts.

Get vehicle persona status -- activity, fatigue, extremes, and health metrics.

Provides structured metrics for an LLM to roleplay a "vehicle with personality", including idle ratio, longest continuous drive, max speed, and vampire drain.

Scan recent drives and charging sessions to check for driving achievements.

Get detailed physical parameters for a single charging session.

Intended for LLM to roleplay a 'vintage data sommelier'.

Discover rare one-time destinations as a weekend 'memory blindbox'.

Finds places visited only once in the lookback period, where the car stayed for at least min_stay_hours -- good candidates for a surprise 'where was I?' weekend trip recommendation.

Generate a polished Markdown monthly driving report with Emoji.

Get driver gamification profile -- rank, milestones, and Easter eggs.

Returns the user's current driving rank, total stats, unlocked milestones, and hints for the next milestone. Easter egg triggers at 160,000 km.

Returns JSON with: current_rank, total_distance_km, total_charges, milestones_unlocked (list), next_milestone_hint, and special_160k Easter egg.

Check today's daily driving quest and progress.

Uses a deterministic hash of the current Beijing date to select one quest from the pool each day. Returns status: 未开始/进行中/已完成.

Find the longest distance driven between two consecutive charges.

Uses window functions on charging_processes to define charge windows, then sums drives within each window to find the record.

Returns JSON with: record_distance_km, start_time, end_time, start_battery_pct, arrival_battery_pct, battery_consumed_pct, efficiency_comment.