AbleSign MCP by usefulapi
Read screens, playlists and media plays, and add media to a screen playlist in AbleSign.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- LOWablesign_list_screen_group_members에서
- LOWablesign_list_proof_of_play_records에서
- LOWablesign_summarize_plays_by_asset에서
- LOWablesign_summarize_asset_plays_by_screen에서
- LOWablesign_add_screen_playlist_items에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"ablesign": {
"url": "https://ablesign.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://ablesign.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (18)
🟢ablesign_list_workspaces
List the workspaces this API key can use, with screen, media file and user counts. Use it to find a workspace_id. AbleSign API: GET /workspaces.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_list_workspace_users(workspace_id)
List the users assigned to one workspace, with their role. AbleSign API: GET /workspaces/{id}/users.
입력 스키마
{
"type": "object",
"properties": {
"workspace_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Workspace id (integer id)."
}
},
"required": [
"workspace_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_list_screens(limit, offset, title, sort_by, orientations, ...)
List digital signage screens with orientation, online state, group and tags. Good first call to see the estate. AbleSign API: GET /screens.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1-200 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Items to skip (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"description": "Filter by title (partial match).",
"type": "string",
"maxLength": 255
},
"sort_by": {
"description": "Sort order (default: as the API returns them).",
"type": "string",
"enum": [
"title_asc",
"title_desc",
"creation_date_asc",
"creation_date_desc",
"heartbeat_date_asc",
"heartbeat_date_desc"
]
},
"orientations": {
"description": "Comma-separated orientations: landscape, portrait, reverse_landscape, reverse_portrait.",
"type": "string",
"maxLength": 255
},
"online_status": {
"description": "Comma-separated online states: online, offline.",
"type": "string",
"maxLength": 255
},
"screen_tags": {
"description": "Comma-separated tag names.",
"type": "string",
"maxLength": 255
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_get_screen(screen_id)
Get one screen: resolution settings, fit mode, timezone, sync role, heartbeat time and tags. AbleSign API: GET /screens/{id}.
입력 스키마
{
"type": "object",
"properties": {
"screen_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Screen id (integer id)."
}
},
"required": [
"screen_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_get_screen_playlist(screen_id)
Get the playlist that one screen plays: its items in order, with duration, transition and schedule per item. AbleSign API: GET /screens/{id}/playlist.
입력 스키마
{
"type": "object",
"properties": {
"screen_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Screen id (integer id)."
}
},
"required": [
"screen_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_list_screen_groups(limit, offset, title, sort_by)
List screen groups (screens that share one playlist). AbleSign API: GET /screen_groups.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1-200 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Items to skip (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"description": "Filter by title (partial match).",
"type": "string",
"maxLength": 255
},
"sort_by": {
"type": "string",
"enum": [
"title_asc",
"title_desc",
"creation_date_asc",
"creation_date_desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_get_screen_group(group_id)
Get one screen group with its title, description and tags. AbleSign API: GET /screen_groups/{id}.
입력 스키마
{
"type": "object",
"properties": {
"group_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Screen group id (integer id)."
}
},
"required": [
"group_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_list_screen_group_members(group_id)
List the screens that belong to one screen group. AbleSign API: GET /screen_groups/{id}/screens.
입력 스키마
{
"type": "object",
"properties": {
"group_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Screen group id (integer id)."
}
},
"required": [
"group_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_list_folders(limit, offset, title, sort_by, parent_folder_id)
List media folders, optionally inside one parent folder. AbleSign API: GET /folders.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1-200 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Items to skip (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"description": "Filter by title (partial match).",
"type": "string",
"maxLength": 255
},
"sort_by": {
"type": "string",
"enum": [
"title_asc",
"title_desc",
"creation_date_asc",
"creation_date_desc"
]
},
"parent_folder_id": {
"description": "List only folders inside this parent folder (integer id).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_list_media_files(limit, offset, title, sort_by, folder_id, ...)
List uploaded images and videos with size, duration, dates and tags. AbleSign API: GET /media_files.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1-200 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Items to skip (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"description": "Filter by title (partial match).",
"type": "string",
"maxLength": 255
},
"sort_by": {
"type": "string",
"enum": [
"title_asc",
"title_desc",
"creation_date_asc",
"creation_date_desc",
"start_date_asc",
"start_date_desc",
"expiry_date_asc",
"expiry_date_desc"
]
},
"folder_id": {
"description": "Only files in this folder (integer id).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"formats": {
"description": "Comma-separated formats: image, video.",
"type": "string",
"maxLength": 255
},
"orientations": {
"description": "Comma-separated orientations: landscape, portrait.",
"type": "string",
"maxLength": 255
},
"tags": {
"description": "Comma-separated tag names.",
"type": "string",
"maxLength": 255
},
"created_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d+)?)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$",
"description": "Only files created on or after this instant."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_get_media_file(media_file_id)
Get one media file with its size, duration, dimensions, validity dates and tags. AbleSign API: GET /media_files/{id}.
입력 스키마
{
"type": "object",
"properties": {
"media_file_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Media file id (integer id)."
}
},
"required": [
"media_file_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_list_web_apps(limit, offset, title, sort_by, tags, ...)
List web apps (web pages shown on screens) with their validity dates and tags. AbleSign API: GET /web_apps.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1-200 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Items to skip (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"title": {
"description": "Filter by title (partial match).",
"type": "string",
"maxLength": 255
},
"sort_by": {
"type": "string",
"enum": [
"title_asc",
"title_desc",
"creation_date_asc",
"creation_date_desc"
]
},
"tags": {
"description": "Comma-separated tag names.",
"type": "string",
"maxLength": 255
},
"created_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d+)?)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$",
"description": "Only web apps created on or after this instant."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_list_proof_of_play_records(from_date, to_date, screen_id, media_file_id, web_app_id, ...)
List raw play records: how often and how long one screen played one asset in a period. The window is at most 92 days. AbleSign API: GET /proof_of_play/records.
입력 스키마
{
"type": "object",
"properties": {
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d+)?)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$",
"description": "Start of the window: records that start at or after this instant."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d+)?)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$",
"description": "End of the window: records that end at or before this instant (max 92 days after from_date)."
},
"screen_id": {
"description": "Only this screen (integer id).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"media_file_id": {
"description": "Only this media file (integer id). Not with web_app_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"web_app_id": {
"description": "Only this web app (integer id). Not with media_file_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Items per page, 1-200 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Items to skip (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"from_date",
"to_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_summarize_plays_by_asset(from_date, to_date, screen_id, title, tags, ...)
Summarize plays per asset (media file or web app): screens it played on, total plays and total seconds. Use it for 'what played most last month'. AbleSign API: GET /proof_of_play/summary.
입력 스키마
{
"type": "object",
"properties": {
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d+)?)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$",
"description": "Start of the window."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d+)?)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$",
"description": "End of the window."
},
"screen_id": {
"description": "Only plays on this screen (integer id).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"title": {
"description": "Only assets whose name contains this text.",
"type": "string",
"maxLength": 255
},
"tags": {
"description": "Comma-separated asset tag names.",
"type": "string",
"maxLength": 255
},
"screen_tags": {
"description": "Comma-separated screen tag names.",
"type": "string",
"maxLength": 255
},
"sources": {
"description": "Comma-separated sources: image, video, website.",
"type": "string",
"maxLength": 255
},
"sort_field": {
"type": "string",
"enum": [
"assetName",
"assetType",
"screenCount",
"totalPlays",
"totalDuration"
]
},
"sort_direction": {
"description": "Default desc.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"description": "Items per page, 1-200 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Items to skip (default 0).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ablesign_summarize_asset_plays_by_screen(media_file_id, web_app_id, from_date, to_date, screen_tags)
Summarize how one asset (media file or web app) played on each screen: play count and total seconds per screen. AbleSign API: GET /proof_of_play/summary/screens.
입력 스키마
{
"type": "object",
"properties": {
"media_file_id": {
"description": "The media file (integer id). Or give web_app_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"web_app_id": {
"description": "The web app (integer id). Or give media_file_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d+)?)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$",
"description": "Start of the window."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d+)?)?(Z|[+-]([01]\\d|2[0-3]):[0-5]\\d)$",
"description": "End of the window."
},
"screen_tags": {
"description": "Comma-separated screen tag names.",
"type": "string",
"maxLength": 255
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴ablesign_create_folder(title, parent_folder_id)
WRITE: create a media folder, optionally inside a parent folder. Creates a new record on each call. AbleSign API: POST /folders.
입력 스키마
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Folder name."
},
"parent_folder_id": {
"description": "Parent folder (integer id). Omit for the top level.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"title"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡ablesign_rename_folder(folder_id, title)
WRITE: change the title of one media folder. Setting the same title again changes nothing. AbleSign API: PUT /folders/{id}.
입력 스키마
{
"type": "object",
"properties": {
"folder_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Folder id (integer id)."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "The new folder name."
}
},
"required": [
"folder_id",
"title"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴ablesign_add_screen_playlist_items(screen_id, items, position)
WRITE: add up to 50 media files or web apps to the playlist of one screen. The content plays on the live screen. Each item needs media_file_id OR web_app_id. Limit: 15 writes per minute and 30 per hour per screen. AbleSign API: POST /screens/{id}/playlist_items.
입력 스키마
{
"type": "object",
"properties": {
"screen_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Screen id (integer id)."
},
"items": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"media_file_id": {
"description": "Media file (integer id). Or web_app_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"web_app_id": {
"description": "Web app (integer id). Or media_file_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"display_duration": {
"type": "integer",
"minimum": 0,
"maximum": 9999999,
"description": "Seconds on screen (video files use their own length)."
}
},
"required": [
"display_duration"
]
}
},
"position": {
"type": "string",
"enum": [
"start",
"end"
],
"description": "Where to insert the items."
}
},
"required": [
"screen_id",
"items",
"position"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거