AbleSign MCP by usefulapi

Read screens, playlists and media plays, and add media to a screen playlist in AbleSign.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
91%
이름 품질
74%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (5)

  • LOWTool 'ablesign_list_screen_group_members' name length outside 3-30 rangeablesign_list_screen_group_members에서
  • LOWTool 'ablesign_list_proof_of_play_records' name length outside 3-30 rangeablesign_list_proof_of_play_records에서
  • LOWTool 'ablesign_summarize_plays_by_asset' name length outside 3-30 rangeablesign_summarize_plays_by_asset에서
  • LOWTool 'ablesign_summarize_asset_plays_by_screen' name length outside 3-30 rangeablesign_summarize_asset_plays_by_screen에서
  • LOWTool 'ablesign_add_screen_playlist_items' name length outside 3-30 rangeablesign_add_screen_playlist_items에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~4,135토큰 (도구 정의)
~1.7 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 3.23%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 18개