add_calendar
ChatGPTUse to show an already-connected calendar on a Mango TV, tablet or browser display; not to create or edit calendar events. Create one calendar widget on an existing freeform page using an already-connected calendar. Ask which calendar and where to place it; use current layout revision. Preserve other widgets. Do not retry uncertain results. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
add_widget
ChatGPTAdd one supported catalog widget to an owned freeform page. Use known catalogId and current layout revision, fetching only missing/stale context. Preserve its verified default proportions and existing widgets. Resolve unspecified placement/source choices before adding; Empty calendars need no connected account and retain all-source defaults. Returns saved layout/revision for follow-up; never blindly retry uncertain writes.
check_device_code
ChatGPTAfter get_setup_guidance identifies a code-paired device and Mango Display shows a code, check that user-provided code in the configured environment only. Browser and native interactive setup use their UI flow instead. Does not activate or register a device. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
confirm_display_removal
ChatGPTExecute the previously prepared Reset & Remove only after explicit affirmative user confirmation in a subsequent message for that exact display. Use its confirmationRef; initial delete request/general edit approval is insufficient. Irreversible and excluded from undo/batches. No automatic retry on failure or timeout; inspect uncertain state. Code-paired devices can show a setup code again on launch; deleted setup is not restored.
connect_calendar_url
ChatGPTConnect an iCal/ICS subscription URL to an existing calendar widget using the Mango API. iCal and ICS use kind ics; iCloud public calendars use icloud_public. Never collect passwords or echo the full URL. After completion name the selected calendars, offer to hide any, and ask the user to check their TV. Do not retry an ambiguous save. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
connect_provider
ChatGPTConnect a requested Google Calendar, Outlook Calendar, Apple iCloud Calendar, Google Tasks, Microsoft To Do, Todoist or Power BI account to an owned compatible display widget. Creates a temporary request and opens browser authorization; this call alone does not connect the account. OAuth providers use their consent screen; iCloud uses the existing Mango web form, never chat or tool inputs for passwords. After user authorization, Mango links the account and may select its calendars or task lists on the widget. Review those selections on verified completion. Calendar and task permissions remain separate. Does not create calendar events or tasks. Do not retry authorization automatically or poll status.
copy_widget
ChatGPTCopy one allowed existing widget with its content/settings onto a freeform page of the same owned display. Use valid layout context/revision; verify copied settings where needed. Preserve original and source connections. Do not bypass version 1 addition scope or silently rearrange existing widgets.
create_page
ChatGPTAppend one empty freeform page to an owned display using valid layout revision (get_layout if missing/stale). Preserve existing pages. Returns new page and layout/revision for immediate follow-up additions; no automatic retry after uncertain results.
get_account
ChatGPTReturn the connected Mango account identity only. Subscription questions use the standalone web app home link; pricing uses the public informational page.
get_browser_display_link
ChatGPTGet the normal launch URL for an owned, successfully created browser display. Share it as a clickable Open display link and ask the user to open it in a new browser tab/window. Explain that the link should be open in only one tab/device at a time; the latest instance receives live updates. Not a preview URL. Never invent a URL or expose its internal parameters separately. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
get_calendar_widget_settings
ChatGPTRead current owned-calendar format, appearance, selections, available settings and revision when missing/stale or requested. Needed state may already come from a batch/completion snapshot. Widget selection is not connected-account inventory; use list_calendar_accounts for that.
get_connection_guidance
ChatGPTGeneric instructions for iCloud Calendar, iCal/ICS subscription URLs, Apple Photos and Google Photos shared album links. No display lookup required. Never ask for passwords in chat.
get_design_guidance
ChatGPTRead the current versioned design policy: across-room TV readability, typography, spacing, recipes, checks and mandatory visual-review checklist. Call before composing or styling a display. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
get_display_controls
ChatGPTRead current owned-display name, orientation, timezone and 24-hour format when needed. Known target/reference suffices; no layout/widget lookup. For a specified change use update_display_controls directly. Generic supported controls use metadata. Display timezone is not Profile Language or an account preference.
get_display_preview
ChatGPTCreate a temporary preview link for an owned display. Treat this link as private; it expires in 15 minutes. Default to page 1 unless the user explicitly requests another page. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
get_display_settings
ChatGPTRead display-wide appearance, visual overlays, supported options, theme recipes and revision. Explains all-pages scope and image-background interaction. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
get_layout
ChatGPTRead pages, widget positions/sizes/layers and revision for an owned display when missing/stale or explicitly requested. Reuse valid returned layout/revision for follow-up edits; do not reread solely to confirm a save.
get_profile
ChatGPTReturn the Mango account represented by the authenticated connection. Email is its display label. The opaque profile ID is tool-only; never display or narrate it.
get_profile_language
ChatGPTRead the current Mango account language and supported choices. No display lookup needed. For generic language choices use get_workflow metadata. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
get_provider_connection_status
ChatGPTCheck a provider connection after the user returns from authorization or explicitly asks. Never poll in a chat loop. connectionRef is internal; never show it.
get_setting_reference
ChatGPTUse this tool alone for generic product questions, including explain the calendar views. No display list, widget ID, layout, account lookup or current settings are needed. Read source-derived web-app setting names, help text, option labels and meanings. Use before answering questions about calendar List, Schedule, Weekly, Monthly or Yearly views, or other widget/display options. Topic all searches all settings; paginate with offset. This is descriptive reference, not new edit support. Never narrate internal field names or backend types.
get_setup_guidance
ChatGPTUse when users want a calendar on their TV, a family dashboard, or an information screen on a supported TV, tablet or browser. List supported devices and guide setup; this does not create calendar events or cast arbitrary apps. Use for questions such as "What displays do you work with?", "Which TVs are supported?", "I want to set up another display", or "I am not sure which device I have". These are device-choice questions, not requests to list existing displays. Identify their TV, browser or native device before asking for a pairing code. Browser setup skips codes. Reuse the device already named; this tool only guides setup and creates nothing. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
get_theme_media_guidance
ChatGPTDiscover approved media sources and theme-sourcing instructions. Use free HD Unsplash/Pexels photos and G-rated GIPHY GIFs/stickers. Preserve source/creator links and inspect suitability. Do not invent image URLs. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
get_undo_history
ChatGPTList up to five available formatting/layout undo steps for one owned display, retained 24 hours. Use when undo is requested; no routine history lookup. Undo excludes connections, selections, content, templates, creation/deletion and media sources. Availability must be verified; references and stored values are internal.
get_widget_settings
ChatGPTRead an owned non-calendar widget: current settings, appearance, supported fields, font parts and revision. Includes clock, weather, news, quotes, notes, images, GIFs, countdown, tasks, chores, meal plans, embeds and other widgets. Source connections and content libraries are not edited. For calendar use the calendar settings tools. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
get_widget_settings_batch
ChatGPTRead settings for several known widgets on one display in one call. Reads run concurrently with shared in-flight display/layout requests. Use only for current configuration or preparing edits, never generic metadata questions. Internal references and revisions must not be displayed to users.
get_workflow
ChatGPTRead capability and setup guidance. Pricing and subscription questions receive informational website links; no account reads needed.
list_calendar_accounts
ChatGPTConnected calendar accounts and selected calendars are different. For questions about connected calendars/accounts, call list_calendar_accounts; do not infer connections from a widget selection. Report all returned accounts, including those with no calendars selected on the current widget. If discussing the current widget too, separately label its selected calendars using get_calendar_widget_settings. Use list_calendars when calendar names within an account are requested. Never say only iCal is connected merely because only iCal is selected. List already-connected calendar accounts on an owned display. Credentials and feed URLs are never returned. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
list_calendars
ChatGPTList calendars from an owned connected account. The test backend may refresh its provider authorization or synchronization subscription. Never creates or edits calendar events. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
list_displays
ChatGPTMention display online/offline status only when the user asks to list displays or explicitly asks for display status. Internal list_displays calls to resolve a target do not authorize status commentary. Omit display status from setup completion, template completion, previews, edits and other responses unless explicitly requested. An offline reading does not mean setup or a saved change failed. List the user’s EXISTING configured displays by name. Status is whether the display is online via its live connection, not account linking or setup. Format each item as “Display name” 🟢 Online or “Display name” ⚪ Offline, with the indicator AFTER the name. If status is unknown, say Status unavailable rather than offline. Use the neutral grey/white circle for offline in chat; exact emoji colour depends on the client. Never call the display connected/disconnected or imply an offline display needs account reconnection. For supported devices, compatibility, or new-display setup use get_setup_guidance instead; do not answer those questions with this account’s display list. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
list_widget_catalog
ChatGPTList supported direct-add widget types and their defaults for an owned display. Reuse a known catalog; no catalog lookup is needed after a plain default clock addition. Use catalogId with add_widget. Version 1 scope differs from subscription eligibility: plan flags are informational, not API-action blockers. backend errors remain authoritative. Preserve template-provided widgets outside direct-add scope.
move_resize_widget
ChatGPTMove/resize one existing widget on its current page with a valid layout revision and pixel coordinates. Fetch get_layout only if missing/stale. Preserve content/other widgets. Adding another widget alone does not authorize this change. Respect lock/pin protection; never blindly retry uncertain writes.
open_display_list
ChatGPTOpen the existing authenticated Mango display list only when the user explicitly asks to see their displays. Do not use this tool to start new-device setup; use get_setup_guidance and keep device choice and code collection in chat. A browser link is available as fallback. Use the original web app screens; never recreate its forms. This does not create or change displays and is not a display preview. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
open_gif_gallery
ChatGPTShow both GIF and sticker tabs with six GIPHY choices each in an inline gallery for one existing GIFs/Stickers widget. Default for ordinary requests such as "add a cat GIF"; users need not say "let me choose". Show choices and wait, rather than applying a result first. Preserve their exact search words. Default kind to sticker unless the user explicitly asks for a GIF; honor explicit sticker requests. Both tabs load initially; further paging loads only the requested kind. Resolve/create the requested widget first, respecting placement guidance. Browsing never changes it. The user selects Use this GIF to save. Do not apply another result while the gallery is open.
open_mango_screen
ChatGPTOpen existing Mango UI: displays, templates, layout or display preview. Use an owned display reference for targeted screens. Templates opens the apply-template picker for that display and requires its display reference; it is not the saved-template library. For listing or managing saved templates, give the standalone web app Profile > My Templates directions instead of calling this screen without a display. Layout uses the contextual page; offer reopening after later edits unless requested. Device setup uses setup_display/setup_browser_display. Payments and Plans is unavailable through MCP; subscription management uses the standalone web app home link.
prepare_display_removal
ChatGPTPrepare irreversible Reset & Remove for one unambiguous owned display. Clarify vague reset intent first. Returns the exact target, warning and confirmation reference. Present the warning and wait for explicit confirmation in a subsequent user message; never confirm in this turn. Deletes setup/pages/widgets, cannot be undone, is not a restart. No automatic retry, batching or linked-display bypass.
prepare_theme_image
ChatGPTValidate and register a direct HD photo URL from images.unsplash.com or images.pexels.com plus its free photo page. Use agent web/image search to find the image first. Checks actual image format/dimensions without downloading the full asset or accepting redirects. Returns a scoped mediaRef for widget/background tools. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
remove_page
ChatGPTRemove a page AND its widgets only when explicitly requested by the user. Identify the page and list its current widget IDs before confirming. Preserves the other pages and account connections; remaining pages are renumbered. Cannot remove the last page or a page containing pinned widgets. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
remove_widget
ChatGPTRemove exactly one owned widget explicitly requested by the user, using valid layout context/revision and confirmRemoval. Identify the target clearly; preserve its page and source accounts. Get layout only if missing/stale. Excluded from undo.
reorder_pages
ChatGPTSet page order on an owned display using every page reference exactly once and current layout revision (get_layout if missing/stale). Preserve contents, geometry and per-page settings.
reorder_widgets
ChatGPTSet one freeform page stacking order with every widget reference exactly once, front-to-back (smaller zIndex is in front). Use current layout revision, fetching only missing/stale state. Preserve geometry/other pages and unrelated relative order. Do not bypass protected widgets.
review_display_design
ChatGPTRead-only advisory review of one owned test page: bounds, overlap, spacing, calendar space, configured font sizes and explicit color-pair contrast. Defaults to across-room TV. Does not capture screenshots or certify visual quality. Use the layout editor for visual review; if one was already shown, offer to reopen it and wait for the user. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
save_display_template
ChatGPTSave the current display as a NEW template directly, without opening the web app. If no name was supplied, suggest “[Display name] Template” and ask for the name; wait for the answer. Reuse an explicitly supplied name without asking again. Resolve the owned display using known context; no layout read is needed. Use a stable operationId for this request and reuse it on transport retry; never automatically retry an uncertain save. Does not apply, overwrite, rename or delete templates, or change the source display. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
search_theme_gifs
ChatGPTFallback GIPHY search for unavailable galleries or an explicitly delegated choice. Ordinary GIF/sticker requests use open_gif_gallery and wait for selection; do not search and auto-apply first. Returns mediaRefs, dimensions, creator and source links. Preview media for suitability; prefer official character channels. No Mango account/provider changes. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
set_display_background_image
ChatGPTSet a prepared HD single-image URL as the shared display background and enable it on specified pages. REPLACES the image for every page already using the shared background. Explain that scope and use only when authorized; for a page-only request use a full-page image widget behind the other widgets. Preserves account connections. Read get_display_settings revision first. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
set_photo_album
ChatGPTValidate and save an Apple Photos or Google Photos shared album URL through Mango. Use an existing image widget via widgetId, or display background via pageIds. Read get_widget_settings or get_display_settings for expectedRevision first. Preserve other photo sources. Background source applies to every page already using it, and enables selected pageIds; explain this scope. Ask the target only if unclear. Never echo shared URLs or invent links. No OAuth/password needed. Do not retry an ambiguous save. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
set_widget_layout_state
ChatGPTExplicitly lock/unlock or pin/unpin an owned widget using valid layout context/revision (get_layout if missing/stale). Do not unlock/unpin merely to make room or bypass a protected edit. Returns saved layout.
set_widget_media
ChatGPTSet one owned image/GIF widget to a prepared photo or selected GIF/sticker. For ordinary GIF/sticker requests open_gif_gallery first and let its selection button save. Never auto-apply a search result unless the user explicitly selects it or delegates the choice. Replaces this widget’s current source selection only; preserves accounts and private source credentials. Read get_widget_settings first. Use add_widget to create a decorative widget first when needed. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
setup_browser_display
ChatGPTUse to turn a browser screen into a calendar, photo or information dashboard. Start a browser display using the existing no-code web setup and template picker. Ask only for its name if missing. No TV, pairing code, browser automation or timezone question is needed. Offer this when a user has no TV available. The existing web app registers the browser device and activates the display only after choosing a template or blank setup. Do not claim completed setup until the completion event. After completion use list_displays to resolve the saved display, then get_browser_display_link and share its clickable launch URL for a separate tab/window. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
setup_display
ChatGPTValidate a device code using only the Mango API and open the existing web setup at template selection. This tool does not activate the display; the web app activates only when the user selects a template or finishes blank setup. Follow get_setup_guidance first: clarify the device, help open Mango Display, and only then ask for its on-screen code and display name if missing. Never ask for timezone or timezone confirmation: omit it for automatic detection; supply an override only if the user explicitly requests one. Browser displays do not use this tool; follow their no-code UI flow. After acceptance, show the template picker and say the display code is accepted; reserve setup success for template completion. The Mango API decides activation eligibility, including reset devices; the connector does not block prior attempts. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
undo_display_changes
ChatGPTUndo requested formatting/layout steps from current get_undo_history for one owned display. Up to five steps/24 hours; no promise before verified availability. Preserve unrelated fields; stop on later conflicting edits or uncertainty without automatic retry. Connections, selections, content, templates, creation/deletion and media-source changes are excluded.
update_calendar_widget_settings
ChatGPTCombine requested calendar view, selection and appearance edits in one owned-widget update with a valid settings revision (read if missing/stale). Validate advertised fields and preserve unspecified selections/settings/geometry. Return saved settings; do not replay uncertain results.
update_display_appearance
ChatGPTChange display-wide default fonts/colors using current get_display_settings revision, reusing valid state. The request must authorize all pages (applyToAllPages=true); a widget/page-only request does not. Widget overrides may remain: for all text update only requested conflicting appearance properties through widget/batch tools. Preserve unrelated styling/sources. Returns saved settings, not proof every rendered text changed.
update_display_batch
ChatGPTApply a user-requested group of settings edits on one display in one call. Combine font, view and calendar selection into one calendar item; combine settings and appearance per other widget. Optionally include ONE display-wide appearance, overlay or prepared background-image change. Use revisions from current reads. Saves remain ordered with existing verification; results explicitly report partial failure. Page creation, movement and page settings use their existing tools in dependency order. Never use for generic questions. Internal references and revisions must not be displayed to users.
update_display_controls
ChatGPTUpdate requested name/orientation/timezone/24-hour controls together on one owned display. No layout lookup required. Portrait/rotation follows web-app dimension behavior; do not independently resize/move widgets to compensate. Change timezone only when requested; resolve an ambiguous zone to a known IANA zone or clarify. Returns saved controls; unsupported settings remain web-app actions.
update_display_overlays
ChatGPTEnable/disable supported visual overlays such as Christmas snow, string lights, Santa/elf, balloons, hearts, fireworks, leaves and Halloween effects. Applies to ALL PAGES. Explain scope and preserve unrelated effects. Read get_display_settings revision. Disable nightMode when enabling visible effects; no invented overlays. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
update_page_settings
ChatGPTChange one owned page rotation delay, transition, auto-rotation or use of the existing display background image. Does not replace the image source or affect other pages. Use get_layout revision. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
update_profile_language
ChatGPTSet Profile > Language using the existing account-wide API, only when explicitly requested. Applies to the whole account and its displays, not one widget or the chat response language. Supported: English, Japanese, Spanish, Italian, German, French, Dutch, Portuguese. Reads back the saved language before confirming. No display lookup needed. Respond with web-app-visible facts only. IDs/references/revisions are tool-only; never narrate them.
update_widget_settings
ChatGPTEdit supported settings/appearance for one owned non-calendar widget using its current revision and contextRef. Weather: send location.locationName from the user; Google supplies coordinates. Ask for region/country if ambiguous; never guess. News: send newsSourceType; the server sets displayName in the same call. Do not separately rename. Preserve title visibility, other widgets, geometry and connections. No retries after uncertain writes.