Log a dive
logbook_create_diveAdd a dive to a PADI logbook by recording title, date, location, type, depth, and time, plus optional details when provided; draft or publish it as appropriate.
Instructions
Add a dive to the user's PADI logbook. Required: title, date (YYYY-MM-DD, not in the future), location, dive_type, and, unless status is Draft, max_depth and bottom_time_min. Everything else is optional: leave out what the user did not say (or send null), never guess. Numbers are in the call's units (see units): depth and visibility in m or ft, temperatures in degrees C or F, weight in kg or lb, cylinder size in litres or cubic feet, pressures in bar or psi, times in minutes. Values are PADI's exact words, listed in each field's description, for example dive_type Boat, BeachShore (shore and beach also work) or Other; status Publish (default) or Draft; gas Air, Enriched_32, Enriched_36, Enriched_40 (these fill the oxygen, nitrogen and helium percentages), or Enriched, Trimix, Rebreather with oxygen_pct, nitrogen_pct and helium_pct summing to 100. Training dives: give training {course, log_number, adventure_dive, skills}. Courses and log numbers: Open (Open Water, 1-4), Advanced (Advanced Open Water, 5 Deep, 6 Navigation, 7-9 elective dives that need adventure_dive), Rescue (10-11), DSD (Discover Scuba Diving, 12), Reactivate (13), SpecialtyAndDistinctive (no log number). Skills are PADI's values for the course (listed in training.skills): Open the flexible skills, Rescue the exercises, Reactivate the requirements. Training dives are saved as Draft; a PADI Pro must then verify them (logbook_submit_for_verification). Returns the saved dive.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>",
"date": "<date>",
"location": "<location>",
"dive_type": "<dive_type>"
},
"name": "logbook_create_dive"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gas | No | Breathing gas: Air (Air (21% oxygen)), Enriched_32 (Nitrox EANx32 (32% oxygen)), Enriched_36 (Nitrox EANx36 (36% oxygen)), Enriched_40 (Nitrox EANx40 (40% oxygen)), Enriched (Nitrox, other mix), Trimix, Rebreather. "EAN32" or "nitrox 32" means Enriched_32. Air and EANx32/36/40 fill the percentages; Enriched, Trimix and Rebreather need oxygen_pct (and helium_pct for Trimix), summing to 100 with nitrogen | |
| date | Yes | Dive date YYYY-MM-DD (a calendar date, not in the future, at most 100 years ago) | |
| suit | No | Exposure suit: NoExposure (No exposure suit), FullSuit_3mm (3 mm full wetsuit), FullSuit_5mm (5 mm full wetsuit), FullSuit_7mm (7 mm full wetsuit), Shorty, SemiDrySuit, DrySuit. "3mm" means FullSuit_3mm | |
| notes | No | Notes (free text) | |
| surge | No | Surge: SomeSurge (Light surge), MediumSurge, BigSurge (Strong surge). "strong" means BigSurge; "none" means no surge | |
| title | Yes | Dive title, for example the site name. Training dives (except Specialty) get the PADI course title instead | |
| units | No | Units of the numbers in this call and its answer: auto (the PADI logbook setting), metric (m, degrees C, bar, kg, litres) or imperial (ft, degrees F, psi, lb, cubic feet). Default: the server setting. | |
| waves | No | Waves: NoWaves, SmallWaves, MediumWaves, LargeWaves | |
| status | No | Publish (a logged dive, the default) or Draft (incomplete: depth and time may be missing) | |
| weight | No | Weight carried, in kg (metric) or lb (imperial) | |
| buddies | No | Buddies (one free-text field, for example "Sam, Kim") | |
| current | No | Current: NoCurrent, SomeCurrent (Light current), MediumCurrent, StrongCurrent. "light" means SomeCurrent | |
| feeling | No | How the dive felt: Amazing, Good, Average, Poor | |
| time_in | No | Time in, HH:MM (not verified with PADI yet; PADI's web app does not show it) | |
| weather | No | Weather: Sunny, Partly Cloudy, Cloudy, Rainy, Windy, Foggy | |
| air_temp | No | Air temperature, in C (metric) or F (imperial) | |
| location | Yes | Dive site or place (free text; logbook_search_dive_sites lists PADI's site names) | |
| time_out | No | Time out, HH:MM (not verified with PADI yet; PADI's web app does not show it) | |
| training | No | Only for training dives (saved as Draft; then use logbook_submit_for_verification) | |
| dive_type | Yes | Dive type: Boat, BeachShore (Shore), Other. "shore" and "beach" mean BeachShore | |
| equipment | No | Extra equipment, for example ["Hood", "Gloves", "Boots"] (PADI offers these three; other items are allowed) | |
| max_depth | No | Maximum depth, in m (metric) or ft (imperial). Needed unless the dive is a Draft | |
| helium_pct | No | Helium in %, 0-100 (default 0) | |
| oxygen_pct | No | Oxygen in %, 0-100 (whole numbers) | |
| visibility | No | Visibility: High (Good (high)), Average, Low (Poor (low)) | |
| water_type | No | Water: Salt (Salt water), Fresh (Fresh water) | |
| dive_center | No | Dive center or operator (free text) | |
| weight_type | No | How the weighting felt: Light (Too light), Good, Heavy (Too heavy) | |
| end_pressure | No | Cylinder pressure at the end, in bar (metric) or psi (imperial) | |
| nitrogen_pct | No | Nitrogen in %, 0-100 (default: the rest to 100) | |
| body_of_water | No | Body of water: Ocean, Lake, Quarry, River, Other | |
| cylinder_size | No | Cylinder size: litres of water volume (metric) or cubic feet (imperial, converted the way the PADI web app does) | |
| cylinder_type | No | Cylinder material: Steel, Aluminum (Aluminium), Other | |
| start_pressure | No | Cylinder pressure at the start, in bar (metric) or psi (imperial) | |
| bottom_time_min | No | Bottom time in whole minutes. Needed unless the dive is a Draft | |
| bottom_water_temp | No | Water temperature at depth, in C (metric) or F (imperial) | |
| surface_water_temp | No | Water temperature at the surface, in C (metric) or F (imperial) | |
| visibility_distance | No | Visibility distance, in m (metric) or ft (imperial) |