What can you do with this server?

This server lets you send real-time content updates to PushToDisplay boards and manage those boards from AI agents or automated pipelines. * Send display updates (pushtodisplay_send_update): Publish text content to a board with rich styling options — text size, font weight, hex colors, background colors, panel targeting (1–4), full-panel mode, content density, and horizontal/vertical alignment. * List boards (pushtodisplay_list_boards): Retrieve all boards owned by the authenticated user. * Get board details (pushtodisplay_get_board): Fetch details of a specific board by its ID. * Create a board (pushtodisplay_create_board): Create a new display board with a name, optional description, and optional layout ID. * Update a board (pushtodisplay_update_board): Modify an existing board's name, description, or layout. * Set default board (pushtodisplay_set_default_board): Designate a board as the user's default, so updates can be sent without specifying a board ID each time. * Delete a board (pushtodisplay_delete_board): Permanently remove a board and all its data (irreversible). * List active devices (pushtodisplay_list_devices): View all active device-board stream connections currently linked to your boards.

Which integrations are available for this server?

Allows GitHub Copilot (VS Code Copilot) to send updates to display boards and manage boards (create, list, delete, set default) via the MCP protocol.

pushtodisplay

Official

by pushtodisplay

Overview Schema Related Servers Score Discussions

TypeScript

Remote

pushtodisplay

Command-line interface and MCP server for Push To Display — send real-time updates to display boards from your terminal or AI agents.

Push to Display — 4-panel regional status board

Install

Run directly with npx (no install needed):

npx pushtodisplay --help

Or install globally:

npm install -g pushtodisplay

Requires Node.js 18+.

Quick start

# Log in (opens browser)
pushtodisplay auth login

# Send an update (uses your default board)
pushtodisplay send "Hello, Display!"

# Send to a specific board
pushtodisplay send -b <board-id> "Deploy completed"

# List your boards
pushtodisplay boards list

Authentication

pushtodisplay auth login

Opens your browser. Sign in and the CLI receives your credentials automatically.

For machines without a browser — SSH sessions, containers, or remote servers:

pushtodisplay auth login --device-code

The CLI prints a URL and a one-time code. Open the URL on any device, enter the code, and approve the login.

Credentials are stored in your OS keychain (macOS Keychain, Linux libsecret, Windows Credential Manager). Falls back to ~/.config/pushtodisplay/ if the keychain is unavailable.

# Check auth status
pushtodisplay auth status

# Log out (clear stored credentials)
pushtodisplay auth logout

Commands

`send`

Send a display update to a board.

# Simple text
pushtodisplay send -b my-board-id "Deploy succeeded"

# Styled text
pushtodisplay send -b my-board-id "Status" --size large --weight bold --color "#00FF00"

# Multiple blocks
pushtodisplay send -b my-board-id "Build:" "passing" --color "#22C55E"

# Panel targeting with layout options
pushtodisplay send -b my-board-id --panel 2 "Right panel content"
pushtodisplay send -b my-board-id --panel 1 --full-panel --density compact --align-x center "Alert"

# Per-block styling with JSON (repeatable)
pushtodisplay send -b my-board-id \
  --block '{"text": "API Health", "size": "large", "weight": "bold"}' \
  --block '{"text": "Uptime: 99.97%", "color": "#22C55E"}'

# Pipe a full JSON payload from stdin
echo '{"boardId":"my-board-id","blocks":[{"text":"From pipe"}]}' | pushtodisplay send --stdin

If no -b flag is provided, the server uses your default board.

Style flags

Flag	Values	Description
`-s, --size`	`small`, `medium`, `large`	Text size
`-w, --weight`	`regular`, `semibold`, `bold`	Font weight
`-c, --color`	Hex color (`#RRGGBB`)	Text color
`--background`	Hex color (`#RRGGBB`)	Background color

Panel flags

Flag	Values	Description
`-p, --panel`	`1`–`4`	Target panel number
`--full-panel`	—	Fill the entire panel area
`--density`	`compact`, `standard`, `spacious`	Content spacing
`--align-x`	`start`, `center`, `end`	Horizontal alignment
`--align-y`	`start`, `center`, `end`	Vertical alignment

Other flags

Flag	Description
`-b, --board`	Board ID
`--block <json>`	Styled block as JSON (repeatable)
`--stdin`	Read full JSON request from stdin

`boards`

pushtodisplay boards list              # List all boards
pushtodisplay boards get <id>          # Get board details
pushtodisplay boards create -n "Name"  # Create a board
pushtodisplay boards create -n "Dash" -l 4  # Create with a layout
pushtodisplay boards delete <id>       # Delete a board

Create options:

Flag	Description
`-n, --name`	Board name (required)
`-d, --description`	Board description
`-l, --layout`	Layout ID

`devices`

pushtodisplay devices list    # List active device-board streams

`config`

pushtodisplay config              # Show current configuration
pushtodisplay config show         # Same as above

JSON output

Add --json to any command for machine-readable output:

pushtodisplay boards list --json
pushtodisplay send -b my-board "test" --json

Configuration

Configuration is resolved in order: environment variables → config file → defaults.

Env var	Description	Default
`PTD_API_URL`	API endpoint	`https://api.pushtodisplay.com`
`PTD_SERVICE_URL`	Service endpoint	`https://services.pushtodisplay.com`
`PTD_IDP_URL`	Identity provider	`https://idp.pushtodisplay.com`
`PTD_CONFIG_DIR`	Config directory	`~/.config/pushtodisplay`

MCP server

The CLI includes a built-in Model Context Protocol server, giving AI agents (Claude, Cursor, VS Code Copilot, and others) direct access to your display boards.

The MCP server inherits your CLI session — if you've run pushtodisplay auth login, it authenticates automatically.

Setup

Claude Code

claude mcp add pushtodisplay -- npx pushtodisplay mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "pushtodisplay": {
      "command": "npx",
      "args": ["pushtodisplay", "mcp"]
    }
  }
}

Cursor

Open Settings → MCP Servers → Add Server, or edit .cursor/mcp.json:

{
  "mcpServers": {
    "pushtodisplay": {
      "command": "npx",
      "args": ["pushtodisplay", "mcp"]
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "pushtodisplay": {
      "command": "npx",
      "args": ["pushtodisplay", "mcp"]
    }
  }
}

Other MCP clients

Any MCP client that supports stdio transport can use Push To Display. The server command is:

npx pushtodisplay mcp

Available MCP tools

Tool	Description
`pushtodisplay_send_update`	Send content to a board
`pushtodisplay_list_boards`	List all boards
`pushtodisplay_get_board`	Get details of a board
`pushtodisplay_create_board`	Create a new board
`pushtodisplay_update_board`	Update a board's name, description, or layout
`pushtodisplay_set_default_board`	Set a board as your default
`pushtodisplay_delete_board`	Delete a board permanently
`pushtodisplay_list_devices`	List active device connections

Commands at a glance

Command	Description
`auth login`	Log in (browser or device code)
`auth logout`	Remove stored credentials
`auth status`	Show current auth status
`send [text...]`	Send a display update
`boards list`	List your boards
`boards get <id>`	Get board details
`boards create`	Create a new board
`boards delete <id>`	Delete a board
`devices list`	List active device connections
`config`	Show current configuration
`mcp`	Start the MCP server

API key authentication

For CI/CD pipelines and scripts where interactive login isn't available, you can authenticate with an API key. Create one from the mobile app or the web portal. API keys start with pt_.

# Via environment variable
export PTD_API_KEY=pt_your_key_here
pushtodisplay send "From CI"

# Or store in keychain
pushtodisplay auth login --api-key pt_your_key_here

Note: API key auth only supports the send command. Use auth login for full access to boards, devices, and config management.

Screenshots

4-panel layout — regional status at a glance

2-panel layout with CI/CD logs Multi-panel with CI/CD pipeline and infrastructure logs

Incident timeline display Incident timeline with color-coded severity

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pushtodisplay/cli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

pushtodisplay

Install

Quick start

Authentication

Browser login (default)

Device code login (headless)

Commands

send

Style flags

Panel flags

Other flags

boards

devices

config

JSON output

Configuration

MCP server

Setup

Claude Code

Claude Desktop

Cursor

VS Code (GitHub Copilot)

Other MCP clients

Available MCP tools

Commands at a glance

API key authentication

Screenshots

License

Resources

Tools

Latest Blog Posts

MCP directory API

`send`

`boards`

`devices`

`config`