{"openapi":"3.1.0","info":{"title":"Nature Remo (BYOK) API","version":"0.1.0","description":"Nature Remo (BYOK) lets an AI assistant read your own Nature Remo data through the Nature Remo API with a key you supply (Nature Remo access token (Cloud API)). Read-only: 8 tools (get_current_user, list_devices, list_appliances, list_device_appliances, list_appliance_signals, list_homes, list_echonet_lite_appliances, get_hourly_electricity). The BYOK key travels with each request, is used for...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-nature-remo.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-nature-remo/docs"},"termsOfService":"https://connectorbay.com/byok-nature-remo/terms"},"servers":[{"url":"https://byok-nature-remo.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-nature-remo/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_current_user":{"post":{"operationId":"get_current_user","summary":"Show the Nature account the token belongs to: id, nickname, country and the temperature and distance units. Use for \"Whi","description":"Show the Nature account the token belongs to: id, nickname, country and the temperature and distance units. Use for \"Which Nature Remo account is my token connected to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_current_userArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_devices":{"post":{"operationId":"list_devices","summary":"List your Nature Remo devices with name, firmware, online flag and the newest temperature, humidity and illuminance read","description":"List your Nature Remo devices with name, firmware, online flag and the newest temperature, humidity and illuminance readings from their sensors. Use for \"What is the temperature and humidity at home right now according to my Remo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_devicesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_appliances":{"post":{"operationId":"list_appliances","summary":"List the appliances registered in the account (air conditioner, TV, light, smart meter and others) with type, the Remo t","description":"List the appliances registered in the account (air conditioner, TV, light, smart meter and others) with type, the Remo that controls them and their remote-control signals. Use for \"Which appliances do I have set up in Nature Remo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_appliancesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_device_appliances":{"post":{"operationId":"list_device_appliances","summary":"List the appliances attached to one Remo device. Use for \"Which appliances are controlled by my Remo in the living room\"","description":"List the appliances attached to one Remo device. Use for \"Which appliances are controlled by my Remo in the living room\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"deviceid":{"description":"Id of a Nature Remo device, as returned by list_devices.","maxLength":200,"title":"Deviceid","type":"string"}},"required":["deviceid"],"title":"list_device_appliancesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_appliance_signals":{"post":{"operationId":"list_appliance_signals","summary":"List the remote-control signals (buttons) saved for one appliance: id, name and icon. Use for \"What buttons are saved fo","description":"List the remote-control signals (buttons) saved for one appliance: id, name and icon. Use for \"What buttons are saved for my Remo TV\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"applianceid":{"description":"Id of an appliance, as returned by list_appliances.","maxLength":200,"title":"Applianceid","type":"string"}},"required":["applianceid"],"title":"list_appliance_signalsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_homes":{"post":{"operationId":"list_homes","summary":"List the homes in the account with name and breaker capacity (member lists and locations are not returned). Use for \"Whi","description":"List the homes in the account with name and breaker capacity (member lists and locations are not returned). Use for \"Which homes are in my Nature account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_homesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_echonet_lite_appliances":{"post":{"operationId":"list_echonet_lite_appliances","summary":"List ECHONET Lite appliances (such as a smart meter) seen by Remo E, with type and the latest property values reported. ","description":"List ECHONET Lite appliances (such as a smart meter) seen by Remo E, with type and the latest property values reported. Use for \"What does my Remo E smart meter report\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_echonet_lite_appliancesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_hourly_electricity":{"post":{"operationId":"get_hourly_electricity","summary":"Get hourly energy series (kWh) for a Remo E device: electricity from the grid, home consumption, solar generation and ex","description":"Get hourly energy series (kWh) for a Remo E device: electricity from the grid, home consumption, solar generation and export. Each point is [unix time, kWh]. Use for \"How much electricity did my home use per hour recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"deviceid":{"description":"Id of a Nature Remo device, as returned by list_devices.","maxLength":200,"title":"Deviceid","type":"string"}},"required":["deviceid"],"title":"get_hourly_electricityArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}