Connect AbleSign

Written By Christopher Scaminaci

Last updated About 2 hours ago

AbleSign is a digital signage platform. It runs screens in lobbies, shops and offices from a web CMS: each screen plays a playlist of images, videos, PDFs and web pages, screens can share a playlist as a screen group, and operating hours switch them on and off. StackJack talks to AbleSign through its REST API, which AbleSign marks as beta.

Connecting AbleSign to StackJack gives your AI assistant a family of ablesign_ MCP tools. MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

See the screens - every screen with its orientation, last check-in time, player version and tags, one screen's full settings and operating hours, and a screen's playlist
Work with screen groups - the groups, their member screens and their shared playlist
Browse the media library - folders, images, videos and PDFs with their dates and tags, and one file's details
See the web apps - the web pages and HTML content shown on screens
Read the workspaces - every workspace with its counts, and the users of a workspace with their roles
Report proof of play - what played where, how often and for how long
Change signage (on Pro plans) - register screens, change screen settings and operating hours, save or edit playlists, set group members, upload or replace media in one step, create and update folders, web apps and workspaces, and delete

How StackJack authenticates to AbleSign

AbleSign uses an API key. The key starts with ak_ and alone authenticates every call: there is no client ID, no sign-in and nothing to refresh. The address is fixed, so there is no URL to enter.

Creating the API key

Sign in to the AbleSign CMS.
Go to Account Settings, then API Keys, and create a key. It starts with ak_.
Copy the key. Treat it like a password.

Connect it in StackJack

Open Connectors, then AbleSign.
Paste the key into API Key.
Click Test connection. StackJack lists your workspaces to prove the key works, and changes nothing.

Paste the key again whenever you save the connection, including when you only rename it.

What is worth knowing before you start

Which workspace a tool acts on

If your account has several workspaces, tools act on the default workspace unless the agent names another one. The AbleSign workspaces tool lists them with their ids, and every screen, group, folder, media, web app and proof-of-play tool takes an optional workspace id. One key reaches every workspace of the organization.

Changes reach your screens

Playlist changes reach your screens within a few minutes, so every change to what a screen shows is marked destructive and asks for approval before it runs:

Playlists: saving a whole playlist (items left out are removed), adding items and editing an item's duration, transition or schedule, on a screen or on a screen group
Screens: registering a screen (it binds the device to your account), changing a screen's settings such as orientation, fit or sync, and changing its operating hours
Screen groups: setting a group's members (screens left out leave the group, and an empty list removes them all)
Media files and web apps: changing their start and expiry dates or a web app's address, and replacing a file's content (it keeps its id, and the old content cannot be restored)
Every delete

Creating a screen group, a folder, a web app or a workspace, renaming a screen group, a folder or a workspace, and uploading a new media file are not marked destructive: nothing new plays until a playlist includes it.

Uploading media in one step

AbleSign uploads a file in three steps: it hands out a temporary storage address, the file is sent there, and the upload is completed. An AI assistant cannot send a file to that address itself, so StackJack offers two one-step tools: one uploads a new image, video or PDF, the other replaces an existing file's content. Give the file as base64 or as an https link StackJack downloads, up to 25 MB, and name its type: JPEG, PNG, MP4 or PDF. StackJack keeps no copy of the file and never shows the storage address. The three raw steps are also available as separate tools.

Rate limits

AbleSign allows 500 requests every 5 minutes for each API key, counted across everything that uses the key. It also limits changes to one item: 15 playlist changes a minute per screen or group, 5 replacements, web app updates or member changes a minute per item, and 200 uploads a day per organization. StackJack paces its requests and backs off when AbleSign asks it to; a limit that is reached is reported with the time to wait.

Proof-of-play reports

Only screens with proof of play turned on report plays. The raw records need a start and an end date at most 92 days apart; the summaries can cover everything AbleSign still keeps. AbleSign keeps records for a limited time, so export them regularly if you need a long history.

When AbleSign refuses a call

The API key is rejected: the key is wrong or was deleted. Create a new one under Account Settings, then API Keys, and paste it in.
Not found: check the id with the matching list tool. Ids belong to a workspace, so name the workspace if the item is not in the default one.
A workspace cannot be deleted: the default workspace, and a workspace that still has users, screens, media files or web apps, cannot be deleted.
The edge refused the request: AbleSign's network edge sometimes refuses a request before the API sees it. That is not the key, and it is not counted against the connection; try again later.

Lists come in pages

Lists return 25 items by default and up to 200 per call, with an offset to page through the rest.

Plans and limits

Read tools are available on the Free tier. Everything that registers, changes, uploads or deletes is Pro. Business reaches the same tools as Pro and differs by monthly call quota.

See the generated AbleSign tool reference for the current inventory, plan assignment, input schemas, and destructive-action labels.

AbleSign tools

ablesign_ · 50 tools · Free 19 · Pro 31

Screens

Tool	What it does
`ablesign_add_screen_playlist_items` Pro · Destructive	DESTRUCTIVE.
`ablesign_delete_screen` Pro · Destructive	DESTRUCTIVE.
`ablesign_get_screen` Free · Read-only	Gets one screen in full: title, orientation, fit mode, timezone, device model and manufacturer, player version, sync settings, last heartbeat and the operating hours.
`ablesign_get_screen_playlist` Free · Read-only	Gets a screen's playlist: the shuffle and transition settings and every item with its id, media file or web app, position, duration, transition and schedule.
`ablesign_list_screens` Free · Read-only	Lists the screens (signage displays) in the workspace, a page at a time: each with its id, title, orientation, last heartbeat (when it last checked in), player version, screen group, proof-of-play flag and tags.
`ablesign_register_screen` Pro · Destructive	DESTRUCTIVE.
`ablesign_replace_screen_playlist` Pro · Destructive	DESTRUCTIVE.
`ablesign_update_screen` Pro · Destructive	DESTRUCTIVE.
`ablesign_update_screen_operating_hours` Pro · Destructive	DESTRUCTIVE.
`ablesign_update_screen_playlist_item` Pro · Destructive	DESTRUCTIVE.

Screen groups

Tool	What it does
`ablesign_add_screen_group_playlist_items` Pro · Destructive	DESTRUCTIVE.
`ablesign_create_screen_group` Pro · Write	Creates an empty screen group.
`ablesign_delete_screen_group` Pro · Destructive	DESTRUCTIVE.
`ablesign_get_screen_group` Free · Read-only	Gets one screen group: its title, description, orientation and member screen ids.
`ablesign_get_screen_group_playlist` Free · Read-only	Gets a screen group's playlist: the shuffle and transition settings and every item with its id, content, position, duration, transition and schedule.
`ablesign_list_screen_group_screens` Free · Read-only	Lists the screens that belong to a screen group, each with its title, orientation, heartbeat, player version and tags.
`ablesign_list_screen_groups` Free · Read-only	Lists the screen groups (screens that share one playlist), a page at a time, each with the ids of its member screens.
`ablesign_replace_screen_group_playlist` Pro · Destructive	DESTRUCTIVE.
`ablesign_set_screen_group_screens` Pro · Destructive	DESTRUCTIVE.
`ablesign_update_screen_group` Pro · Write	Renames a screen group or changes its description.
`ablesign_update_screen_group_playlist_item` Pro · Destructive	DESTRUCTIVE.

Folders

Tool	What it does
`ablesign_create_folder` Pro · Write	Creates a media library folder, at the root or inside another folder.
`ablesign_delete_folder` Pro · Destructive	DESTRUCTIVE.
`ablesign_get_folder` Free · Read-only	Gets one folder: its title, parent folder id and creation date.
`ablesign_list_folders` Free · Read-only	Lists the media library's folders, a page at a time, each with its parent folder id (null at the root).
`ablesign_update_folder` Pro · Write	Renames a folder.

Media files

Tool	What it does
`ablesign_delete_media_file` Pro · Destructive	DESTRUCTIVE.
`ablesign_finish_media_replace_upload` Pro · Destructive	DESTRUCTIVE.
`ablesign_finish_media_upload` Pro · Write	Step 3 of AbleSign's three-step upload, after the file's bytes were sent to the address step 1 returned: AbleSign processes the file (thumbnail, metadata) and creates the media file.
`ablesign_get_media_file` Free · Read-only	Gets one media file in full, including accessUrl, a signed download link for the file that AbleSign keeps valid for a few days.
`ablesign_init_media_replace_upload` Pro · Destructive	DESTRUCTIVE.
`ablesign_init_media_upload` Pro · Write	Step 1 of AbleSign's three-step upload: tells AbleSign about a file and answers with an uploadId and a signed storage address, valid for a short time, that accepts the file's bytes in an HTTP PUT with the same Content-Type.
`ablesign_list_media_files` Free · Read-only	Lists the images, videos and PDFs in the media library, a page at a time: each with its id, title, original filename, type, size, orientation, duration, dimensions, thumbnail, start and expiry dates, folder and tags.
`ablesign_replace_media_file` Pro · Destructive	DESTRUCTIVE.
`ablesign_update_media_file` Pro · Destructive	DESTRUCTIVE.
`ablesign_upload_media_file` Pro · Write	Uploads an image, video or PDF to the AbleSign media library in ONE call: StackJack starts the upload, sends the file to the storage address AbleSign returns (never shown to you), and finishes it, then answers with AbleSign's raw JSON for the new media file.

Web apps

Tool	What it does
`ablesign_create_web_app` Pro · Write	Creates a web app from a website address (url) or from HTML (html): give exactly one.
`ablesign_delete_web_app` Pro · Destructive	DESTRUCTIVE.
`ablesign_get_web_app` Free · Read-only	Gets one web app in full: its url (null for HTML content), zoom, dates and tags, and for HTML content accessUrl, a signed link to its HTML.
`ablesign_list_web_apps` Free · Read-only	Lists the web apps (web pages or HTML content shown on screens), a page at a time, each with its id, title, thumbnail, start and expiry dates and tags.
`ablesign_update_web_app` Pro · Destructive	DESTRUCTIVE.

Workspaces

Tool	What it does
`ablesign_create_workspace` Pro · Write	Creates an empty workspace in the organization.
`ablesign_delete_workspace` Pro · Destructive	DESTRUCTIVE.
`ablesign_get_workspace` Free · Read-only	Gets one workspace with its title, description, color, whether it is the default, and its user, screen and media counts.
`ablesign_list_workspace_users` Free · Read-only	Lists the users of a workspace: each with their role, whether they own the account, whether they are disabled or have an invitation pending, their profile (name, email, avatar), and their role and permissions in every workspace of the organization.
`ablesign_list_workspaces` Free · Read-only	Lists every workspace in the AbleSign organization, each with its id, title, color, whether it is the default, and its user, screen and media counts.
`ablesign_update_workspace` Pro · Write	Renames a workspace or changes its description or color.

Proof of play

Tool	What it does
`ablesign_list_proof_of_play_records` Free · Read-only	Lists the raw proof-of-play records screens reported, oldest first, a page at a time: each covers one reporting period on one screen for one media file or web app, with its play count and total time on screen in milliseconds.
`ablesign_summarize_proof_of_play` Free · Read-only	Summarizes proof of play per media file or web app, a page at a time: the number of screens it played on, its total plays and its total time on screen in milliseconds.
`ablesign_summarize_proof_of_play_by_screen` Free · Read-only	Summarizes where ONE media file or web app played: one row per screen, most plays first, with its play count and total time on screen in milliseconds.

Was this helpful?

Still need help? Ask the team