My Otovo
get_my_otovoReads what a customer can see in their Otovo portal, one view at a time. Changes nothing. With a scheduling code and no account, three views: booking_status (the address, services offered, the visit already scheduled and whether it can be moved or cancelled, open access questions, the support line), booking_options (code and service_type, optional week_start, location_id and promo_code: bookable times for a new visit, best first, with the price and what the promo code does) and reschedule_options (code, optional week_start: times the scheduled visit can move to). With a connected account, site_id selects one of the customer's sites when they have several: sites, profile, home, summary; monitoring (production now, equipment status, alerts and when each reading was taken; a missing or stale reading is not zero production), monitoring_page, monitoring_history (node_id, query range day|week|month|year and date), monitoring_devices (node_id), monitoring_device (node_id, device_id), monitoring_energy_rate; connect_system (the monitoring providers Otovo connects, the fields each connection needs and the portal's setup steps; id = one provider); energy, energy_usage (query start_date, end_date, granularity), energy_bills, energy_plans; service (visits, work orders, bookable services), appointment (id), appointment_tracking (id: where the crew is on the day), scheduling (what can be booked or moved, open access questions), booking_options (service_type, optional week_start and promo_code) and reschedule_options (optional week_start); work_order (id), repair (id), site_report (id; photos stay in the portal); quotes, quote (id); billing, billing_records (query limit, cursor), billing_record (id; the invoice PDF is a portal link), payment_methods, subscription, subscription_plans, subscription_terms (query tier, billing_interval); documents (pending, signed, project and historical); leases, lease (id); hour_bank; notification_settings. Reading booking times for a connected customer can create their own Otovo scheduler link; nothing is sent to them. Serves every Otovo region: without a connected account the scheduling code, preview or address selects the region; a connected customer is served where their account lives.
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": {
"view": "<view>"
},
"name": "get_my_otovo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The record a single-record view is about: an appointment, work order, site report, quote, billing record (its quote id), lease (project id), or a provider key for connect_system. | |
| code | No | Without an account: the customer's scheduling code, the last part of the otovo.com/book/... link they were sent. It cannot be looked up from other details. | |
| view | Yes | What to read. See the tool description for what each view holds and which parameters it takes. | |
| query | No | Extra filters the view takes, as named in the description: for example {"range":"month","date":"2026-10-01"} for monitoring_history, {"limit":20} for billing_records, {"tier":"care"} for subscription_terms. | |
| node_id | No | A monitoring node from view monitoring (monitoring_history, monitoring_devices, monitoring_device). | |
| site_id | No | Connected customers: one of their own sites, a site_id from view sites. Needed when they have more than one. | |
| device_id | No | A device from view monitoring_devices (monitoring_device). | |
| promo_code | No | booking_options: a promo code the customer gave. The answer's charge is the price with it and promo says whether it applied, their Otovo Care discount is larger, or why it was refused. | |
| week_start | No | booking_options, reschedule_options: earliest date to search from, YYYY-MM-DD. Step it forward a week at a time to look further out. | |
| location_id | No | booking_options: which property, when the booking covers more than one. | |
| service_type | No | booking_options: the kind of new visit. booking_status or view scheduling lists what is actually offered. |