Operto MCP by usefulapi
Read properties, reservations, guest access codes, smart locks and thermostats in Operto.
我該用這個嗎
品質與安全性
發現項目（1）
- LOWTool 'operto_list_property_thermostats' name length outside 3-30 range在 operto_list_property_thermostats 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"operto": {
"url": "https://operto.usefulapi.io/mcp"
}
}
}遠端端點
https://operto.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具（8）
🟢operto_list_properties
List the properties (units) in your Operto account with their Operto id, partner_id, name and subscription state. Good first call: the ids feed the other tools. Operto API: GET /v2/partners/properties.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢operto_get_property(property_id, keyid)
Get one property by id, including its details and current room status (for example clean-available, guest-checking-in, cleaning-started). Operto API: GET /v2/partners/properties/{property_id}.
輸入結構描述
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The Operto property id (from operto_list_properties), or the partner_id with keyid=partner."
},
"keyid": {
"description": "Set to \"partner\" when the id you pass is your own partner id (partner_id / partner_reservation_id) instead of the Operto id.",
"type": "string",
"enum": [
"partner"
]
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢operto_list_reservations(property_id, keyid)
List the reservations of one property: status, check-in and check-out time, guest name, phone, email and door codes. Contains personal guest data. Operto API: GET /v2/partners/properties/{property_id}/reservations.
輸入結構描述
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The Operto property id, or the partner_id with keyid=partner."
},
"keyid": {
"description": "Set to \"partner\" when the id you pass is your own partner id (partner_id / partner_reservation_id) instead of the Operto id.",
"type": "string",
"enum": [
"partner"
]
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢operto_get_reservation(reservation_id, keyid)
Get one reservation by id: status, dates, guest contact data and the guest access and checkout codes. Contains personal guest data. Operto API: GET /v2/partners/reservations/{reservation_id}.
輸入結構描述
{
"type": "object",
"properties": {
"reservation_id": {
"type": "string",
"description": "The Operto reservation id, or the partner_reservation_id with keyid=partner."
},
"keyid": {
"description": "Set to \"partner\" when the id you pass is your own partner id (partner_id / partner_reservation_id) instead of the Operto id.",
"type": "string",
"enum": [
"partner"
]
}
},
"required": [
"reservation_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢operto_list_locks(property_id, keyid)
List the smart locks of one property with name, battery level, locked state and device_id. Read only: this tool does not open or close a lock. Operto API: GET /v2/partners/properties/{property_id}/locks.
輸入結構描述
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The Operto property id, or the partner_id with keyid=partner."
},
"keyid": {
"description": "Set to \"partner\" when the id you pass is your own partner id (partner_id / partner_reservation_id) instead of the Operto id.",
"type": "string",
"enum": [
"partner"
]
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢operto_list_thermostats
List every smart thermostat in your organization with its property, type (for example EcoBee, Tado) and online status. Operto API: GET /v2/partners/thermostats.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢operto_list_property_thermostats(property_id, keyid)
List the smart thermostats of one property with type and online status. Operto API: GET /v2/partners/properties/{property_id}/thermostats.
輸入結構描述
{
"type": "object",
"properties": {
"property_id": {
"type": "string",
"description": "The Operto property id, or the partner_id with keyid=partner."
},
"keyid": {
"description": "Set to \"partner\" when the id you pass is your own partner id (partner_id / partner_reservation_id) instead of the Operto id.",
"type": "string",
"enum": [
"partner"
]
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢operto_get_thermostat(thermostat_id)
Get one thermostat by id: online status, current temperature in Fahrenheit and Celsius, and any active hold. Operto API: GET /v2/partners/thermostats/{thermostat_id}.
輸入結構描述
{
"type": "object",
"properties": {
"thermostat_id": {
"type": "string",
"description": "The thermostat id (from operto_list_thermostats)."
}
},
"required": [
"thermostat_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據