CastHub MCP Server

Model Context Protocol server for digital signage. Manage TV fleets, presentations, schedules, and emergency alerts from Claude, ChatGPT, Microsoft Copilot, Google Gemini, Cursor, or any MCP-compatible client.

<!-- TODO: replace placeholder demo.gif with a real recording -->

What this is

CastHub MCP Server lets AI assistants directly control digital signage networks. Instead of clicking through a dashboard, you tell your assistant to update the lobby TV, push an emergency alert to all stores, or schedule next week's promotional content. The server exposes approximately 45 tools across devices, presentations, schedules, alerts, groups, and device commands, so the whole CastHub platform is reachable in natural language.

Why this exists

Digital signage management is repetitive, multi-step work that maps cleanly to natural language. Several signage platforms (Fugo, Revel Digital, Screenly) have shipped MCP support over the last year. CastHub differentiates in four ways. You connect to a hosted endpoint that uses OAuth 2.0 with PKCE and dynamic client registration, so you never paste an API key or run a local process for the standard path. Every tool ships with annotations (ReadOnly, Destructive, Idempotent) that drive proper confirmation prompts in each AI client before a disruptive action runs. Pricing is flat-rate with unlimited screens on the Pro plan rather than per-screen. And CastHub is an approved CMS partner on the Amazon Signage Stick.

Connect from any AI assistant

The CastHub MCP server is hosted at https://webapi.cast-hub.com/mcp. Authentication uses OAuth 2.0 with PKCE and dynamic client registration, so you sign in once through your AI assistant and approve access. No API keys, no local install required for the standard path.

Connection instructions for each client are in the CastHub docs:

• Connect Claude (web, Desktop, mobile)
• Connect ChatGPT
• Connect Microsoft Copilot (Copilot Studio and GitHub Copilot in VS Code)
• Connect Google Gemini (Gemini Enterprise and Gemini CLI)
• Connect Cursor
• CastHub CLI for shell automation and CI

Full setup is at https://cast-hub.com/mcp.

Local install for stdio-only clients

For MCP clients that can only launch a local stdio process, install the SDK and point it at the hosted endpoint:

npm install -g @cast-hub/mcp

{
  "mcpServers": {
    "casthub": {
      "command": "casthub-mcp",
      "env": {
        "CASTHUB_API_KEY": "your-api-key-here"
      }
    }
  }
}

The SDK is a transport shim. All tool execution happens server-side at https://webapi.cast-hub.com/mcp.

Available tools

The server exposes approximately 45 tools across Devices, Device groups, Presentations, Schedules, Alerts, Device commands, and Account and dashboard. The authoritative tool list comes from calling tools/list against the live MCP server, which is the source of truth and may have grown since this README was last updated.

The tables below reflect the tool set as of the last README update. The live server is authoritative; tool inventory may have grown since.

Devices

Tool name	Description
get_devices	List all devices grouped by device group
update_device	Update a device's name
delete_device	Delete a device by ID
change_device_group	Move a device to a different group
issue_device_command	Send a remote command to an Amazon Signage Stick
get_device_commands	List recent remote commands and their status
create_device_command_schedule	Create a recurring command plan for a device group
get_device_command_schedules	List command plans for a device group
toggle_device_command_schedule	Enable or disable a command plan
delete_device_command_schedule	Delete a command plan

Device groups

Tool name	Description
create_device_group	Create a new device group
update_device_group	Update a device group's title
delete_device_group	Delete a device group

Presentations

Tool name	Description
get_presentations	List all presentations
get_presentation	Get a specific presentation with all slides
create_presentation	Create a new presentation
create_presentation_with_content	Create a presentation with slides in one step
update_presentation	Update presentation properties
delete_presentation	Delete a presentation
assign_presentation	Assign a presentation to a specific device group
assign_presentation_to_default	Assign a presentation to the default group
register_slide_image_upload	Step 1 of 3 for uploading an image slide
acknowledge_slide_image_upload	Step 3 of 3 for uploading an image slide
register_slide_video_upload	Step 1 of 3 for uploading a video slide
acknowledge_slide_video_upload	Step 3 of 3 for uploading a video slide

Schedules

Tool name	Description
get_schedules	List all schedules
get_linear_schedule	Get a Simple Schedule with all time entries
get_weekly_schedule	Get a Weekly Schedule with all time slots
assign_schedule	Assign a schedule to a device group
remove_schedule	Remove the schedule from a device group
delete_schedule	Delete a schedule

Alerts

Tool name	Description
assign_alert_presentation	Set the alert presentation for a specific device group
assign_alert_presentation_to_default	Set the alert presentation for the default group
remove_alert_presentation	Remove the alert presentation from a group
start_all_alerts	Start alerts on all device groups
start_group_alert	Start an alert on a specific group
start_text_alert	Start a text alert on all device groups
start_text_alert_for_group	Start a text alert on a specific group
stop_all_alerts	Stop alerts on all groups
stop_group_alert	Stop an alert on a specific group

Account and dashboard

Tool name	Description
who_am_i	Check current login status
get_user_info	Get user profile and subscription details
get_dashboard	Get a comprehensive dashboard overview
get_current_utc_time	Returns the current UTC timestamp

How CastHub MCP compares

Capability	CastHub MCP	Screenly MCP	Revel Digital MCP	Fugo MCP
MCP server available	Yes	Yes	Yes	Yes
Hosted endpoint (no local CLI install)	Yes	No (CLI-based)	Yes	Yes
OAuth 2.0 with PKCE and dynamic client registration	Yes	Unknown	Unknown	Unknown
Per-tool annotations for confirmation prompts (ReadOnly, Destructive, Idempotent)	Yes	Unknown	Unknown	Unknown
Amazon Signage Stick native support	Yes	No	Partial	No
Flat-rate pricing	Yes	Per-screen	Per-screen	Per-screen
Open-source player option	Roadmap	Yes (Pi via Anthias)	No	No

Example usage

Update content for a specific group of screens

Prompt: "Push the new winter sale presentation to all 12 store screens for next week"

Tools called: get_presentations, assign_presentation, assign_schedule

Trigger an emergency alert

Prompt: "Start a fire drill alert across the warehouse group right now"

Tools called: start_text_alert_for_group

Audit fleet health

Prompt: "Show me all devices that have not checked in for over 24 hours"

Tools called: get_devices (filtered client-side)

Roll out content from Microsoft Copilot or Gemini

Prompt: "Schedule the new menu board presentation across the downtown cafe group for tomorrow morning"

Tools called: get_presentations, assign_presentation, assign_schedule

More walkthroughs in examples/.

Documentation

• CastHub MCP docs
• CastHub Dashboard
• CastHub pricing
• Signup

License

MIT. See LICENSE.

Contributing

Issues and pull requests welcome at github.com/Cast-Hub/mcp-server/issues. For commercial questions or partnership inquiries, contact info@cast-hub.com. For customer support questions, contact support@cast-hub.com.