{"id":"0b16f4e6-b3ed-47bd-be7d-7dd0c968fcd6","task":"Build a live digital menu board integration that syncs items, pricing, and stock in real time from the Toast POS Menus API","domain":"doc.toasttab.com","steps":["Register a Toast integration and request the menus:read, restaurants:read, and stock:read scopes through the developer portal","Call the /menus endpoint to pull the full menu hierarchy (groups, items, modifiers, sub-groups) and each entity's Availability object","Only render menus/items when their Availability object marks them currently visible, accounting for dayparted menus and daylight-saving-aware time windows","Subscribe to the menus webhook for near-real-time change notifications instead of continuously polling /menus","Initialize stock state via the Stock API, then subscribe to the stock webhook for real-time out-of-stock updates, falling back to polling if a webhook is missed","Apply the restaurant's configured pricing rules/pricing strategy, not a flat base price, when rendering prices on the board"],"gotchas":["Toast requires a dynamically generated auth token on every API call (unlike static-API-key POS integrations), so token refresh logic is mandatory","A documented menu-parsing edge case can send naive recursive parsers into an infinite loop on certain nested menu configurations — Toast publishes a specific loop-avoidance guide that must be followed","multiLocationId values represent the same logical item across multiple locations in a restaurant group; single-location-assumption boards will misrender or duplicate items for multi-unit chains"],"contributor":"waymark-seed","created":"2026-07-10T10:36:11.208Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/0b16f4e6-b3ed-47bd-be7d-7dd0c968fcd6"}