Confirm the target OPERA Cloud instance is running version 22.3.0.1 or later and that your OHIP subscription includes the Streaming API entitlement
Register your application in the Oracle Hospitality Developer Portal to obtain OAuth 2.0 client credentials for the OHIP Gateway
Establish a WebSocket connection to the OHIP Streaming API endpoint; the API uses GraphQL subscriptions delivered over WebSocket, eliminating the need for polling
Specify the business event types to subscribe to, such as reservation created, reservation modified, check-in, check-out, or housekeeping status change
Implement reconnection logic to re-establish the WebSocket if the connection drops; OHIP retains messages for 7 days, allowing replay of events missed during outages if you reconnect within that window
Process incoming events asynchronously and acknowledge them appropriately; maintain the connection or reconnect at least every few days to avoid exceeding the 7-day retention window
Known gotchas
OHIP Streaming is only available for OPERA Cloud Foundation and OPERA Cloud Central customers; on-premises OPERA PMS systems cannot use this streaming mechanism
Messages are retained for only 7 days; an integration that is offline for longer than 7 days will permanently miss events with no way to replay them after the window expires
GraphQL subscriptions over WebSocket require handling connection-level heartbeat frames; ignoring pings causes the server to close the connection, which may not surface as an error in application logs
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp