CastHub MCP Server
Model Context Protocol server for digital signage. Manage TV fleets, presentations, schedules, and emergency alerts from Claude, Cursor, ChatGPT, or any MCP client.
What this is
CastHub MCP Server lets AI assistants directly control digital signage networks. Instead of clicking through a dashboard, you tell Claude to update the lobby TV, push an emergency alert to all stores, or schedule next week's promotional content. The server exposes 30+ tools covering devices, presentations, schedules, alerts, and groups across the CastHub platform.
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 MCP differentiates on hosted endpoint architecture (no local install required for the basic path), a governance layer with preview-confirm-rollback for safe agent use, and native Amazon Signage Stick integration.
Two ways to connect
Option A: Hosted endpoint (recommended)
No installation required. Add the CastHub MCP server to your Claude Desktop, Cursor, or other MCP client config:
{
"mcpServers": {
"casthub": {
"url": "https://api.cast-hub.com/mcp",
"auth": {
"type": "bearer",
"token": "YOUR_CASTHUB_API_KEY"
}
}
}
}
Generate your API key at dashboard.cast-hub.com.
Option B: Install the SDK locally
For MCP clients that require a local stdio process:
npm install -g @cast-hub/mcp
Then configure your client:
{
"mcpServers": {
"casthub": {
"command": "casthub-mcp",
"env": {
"CASTHUB_API_KEY": "your-api-key-here"
}
}
}
}
The SDK forwards MCP protocol calls to the CastHub hosted endpoint. All tool execution happens server-side; the SDK is a transport shim.
Available Tools (30+)
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 utility
| 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 |
| Governance layer (preview, confirm, rollback) | Yes | No | No | No |
| 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)
More walkthroughs in examples/.
Documentation
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.