Screen Pulse

Change an AI menu with a plain-language instruction (prices, items, sold out, colors, text…). For multi-slide menus, pass slide_number to redesign only that slide (1 credit); otherwise the whole menu is redesigned (1 credit per slide). Runs in the background — check with get_ai_menu. Screens already showing this menu update automatically when it is ready. The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.

edit_ai_menu

Rename a location or change its address. Pass the location (name or id) and only the fields to change. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

edit_location

Get one AI menu: status (use this to check progress after create/edit/animate), versions, animation progress, and a preview image of the latest version.

get_ai_menu

Show the AI Menu Studio design credits (1 per slide) and animation credits (1 per animated slide) left on this account, and when they refresh.

get_ai_menu_credits

Show what content is assigned to a screen: the last pushed item (template, Canva design, AI menu or image, with its picture) and any active schedules. Use take_screen_snapshot to see the TV itself.

get_current_content

Get a screen's device details: model, OS, Screen Pulse app version, memory, storage, resolution and network. Asks an online player for a fresh report first.

get_device_details

Get the live status of one screen: online/offline, last check-in time, orientation and location.

get_screen_status

List the owner's AI Menu Studio menu boards with status (generating / ready / failed), orientation, slide count and whether each can be published.

list_ai_menus

List screen and account alerts (offline screens, content problems…). Default: unresolved alerts only.

list_alerts

List the owner's business locations with how many screens each has.

list_locations

List content schedules (default content plus time windows) on this account, optionally only those on one screen.

list_schedules

List the owner's TV screens with name, 6-digit screen number, online/offline status, orientation, location and last check-in. Optionally filter by location name or status. Call this before any tool that needs a screen number — never invent one.

list_screens

Show everything that can be put on a screen, with preview pictures: Screen Pulse templates (the ready-made library), the owner's saved Canva designs and their AI Menu Studio menus. Each item has a template_id (e.g. "predefined:DAF…", "saved:DAF…", "ai_menu:66f…") to use with push_template_to_screens or in a schedule. Filter by source, search text or orientation. The pictures are shown in the Screen Pulse panel.

list_templates

Move a screen to another of the owner's locations (by location name from list_locations). The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

move_screen_location

Add a new TV to the account using the 6-digit code shown on the TV by the Screen Pulse app. If the account has more than one location, a location is required (ask the user which one). The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result. BEFORE calling, ask the user: (1) the 6-digit code shown on the new TV; (2) the name for the screen; (3) which location it belongs to (if they have several).

pair_screen

Pause (active=false) or resume (active=true) a schedule. The account owner approves it in Screen Pulse first: the first call returns an approval link for the user; after they approve, call again with approval_id for the result.

set_schedule_active

Put a template on one or more screens right away, replacing what they show: a Screen Pulse template, a saved Canva design or an AI menu (template_id from list_templates). When the user has not said which screens (e.g. they tapped "Push to screens"), call it WITHOUT screens: it shows their screens to pick from in the panel (nothing changes, no approval for that step); then call again with the picked screens. Screens that are in a schedule go back to the schedule at its next change unless detach_from_schedules is true. The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.

push_template_to_screens

Show an AI menu on one or more screens, replacing what they show. When the user has not said which screens (e.g. they tapped "Push to screens"), call it WITHOUT screens: it shows their screens to pick from in the panel (nothing changes and no approval is needed for that step); then call again with the picked screens. Set animated=true to publish the animated version (after animate_ai_menu finishes). For multi-slide menus, seconds_per_slide sets how long each slide shows (5–30). The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.

publish_ai_menu_to_screens

Read the sections, items and prices from a photo or screenshot of a menu (image from the conversation as `image`, or `image_url`). Returns structured items to review with the user before create_ai_menu. Uses no credits.

extract_menu_from_image

Rename an AI menu. The account owner approves it in Screen Pulse first: the first call returns an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

rename_ai_menu

Rename one of the owner's screens. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

rename_screen

Give a screen a new 6-digit screen number (e.g. if the number was shared or the TV is being handed over). The screen stays paired with the same name and location, but what it showed is cleared and must be pushed again. The TV must be online and running a recent Screen Pulse app. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

reset_screen_id

Soft-restart the Screen Pulse player on a screen (fixes a frozen or stuck display). The screen must be online. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

reload_screen

Make an earlier version of an AI menu the current one (version numbers from get_ai_menu). No credits. Screens showing this menu are not changed until you publish. The account owner approves it in Screen Pulse first: the first call returns an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

restore_menu_version

Switch a screen's display between landscape and portrait (for a TV mounted the other way). The screen must be online. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

rotate_screen

How-to answers about Screen Pulse Core and AI Menu Studio: getting started, player apps and supported devices, pairing a TV, publishing, Canva, scheduling, images, AI Menu Studio credits, offline screens, plan and billing. Use it for "how do I…" questions instead of guessing.

screen_pulse_help

Take a fresh picture of what one or more screens are showing right now and show it. Pass screen (number or name), or screens (several), or screen "all" for every online screen. Offline screens cannot take a new picture; their last snapshot is shown instead.

take_screen_snapshot

Put back what a screen showed before the last change made through this connector (a template, Canva design or AI menu push). The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.

restore_previous_content

Change an existing schedule (id from list_schedules). Only pass the fields to change; time_windows, when given, replaces all windows. The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.

update_schedule

Wake a screen whose player is paused or in the background. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.

wake_screen

Show which Screen Pulse account this connection is signed in as, which products it has, how many screens it owns and the screen limit (how many more can be added). Use it to confirm the connection works.

whoami