Log inSubmit server
Cli logo

Cli

by pushtodisplay

Sends real-time, styled updates to Push To Display boards and manages boards and connected devices through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Cli

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "pushtodisplay-cli": {
      "command": "npx",
      "args": [
        "-y",
        "pushtodisplay"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y pushtodisplay

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The pushtodisplay/cli MCP server lets AI agents send structured, real-time content to Push To Display boards on connected iOS and Android devices. It exposes tools for updating displays, managing boards, selecting a default board, and listing active device connections. The server uses the CLI's stored Push To Display session and runs over stdio through the `pushtodisplay mcp` command. Choose it when an agent needs to publish operational status, alerts, or other structured content to selected display panels.

Use cases

  • Send deployment status to a selected display board
  • Route alerts to a specific display panel
  • Create and organize boards for different workflows
  • Check which display devices are currently connected

Key features

  • Send structured updates to Push To Display boards
  • Target multi-panel layouts
  • Create, update, select, and delete boards
  • List active device connections
  • Reuse CLI authentication
  • Support machine-readable JSON workflows

Tools8

What Cli lets your agent do. Expand a tool for its parameters.

Self-reported~104 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

17/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · pushtodisplay (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads1.1kPackage downloads in the last 30 days.
Last commit19d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed8Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Cli works

What pushtodisplay/cli MCP server does

The pushtodisplay/cli MCP server connects AI agents to Push To Display boards. It can send content to a selected board, inspect available boards, create or modify boards, choose a default board, delete boards, and list active device connections. Updates are delivered to display boards associated with the Push To Display mobile app on iOS and Android devices.

The server supports display-oriented content rather than general-purpose messaging. Its underlying CLI can send plain text, multiple content blocks, styled blocks, and JSON payloads. Updates can target panels in a multi-panel layout and can specify text size, weight, color, background color, spacing density, and horizontal or vertical alignment.

How it works

The MCP process runs locally through Node.js and communicates with an MCP client using stdio. The command is exposed by the pushtodisplay npm package with the mcp subcommand. An agent can then invoke the available MCP tools instead of issuing CLI commands directly.

The tool set includes pushtodisplay_send_update, pushtodisplay_list_boards, pushtodisplay_get_board, pushtodisplay_create_board, pushtodisplay_update_board, pushtodisplay_set_default_board, pushtodisplay_delete_board, and pushtodisplay_list_devices. Board updates use the user's default board when no specific board is selected, where supported by the request.

Setup and configuration

Install or run the CLI with Node.js 18 or newer. The documented MCP command is npx pushtodisplay mcp; the package can also be installed globally with npm. MCP clients that support stdio can run the same server command.

Before using the tools, authenticate with a Push To Display account. Browser login opens a sign-in flow, while device-code login supports headless machines such as SSH sessions, containers, and remote servers. Credentials are stored in the operating system keychain when available, with a configuration-directory fallback. The pushtodisplay/cli MCP server reuses this CLI session, so a prior CLI login supplies its authentication.

The service endpoints and configuration location can be changed with PTD_API_URL, PTD_SERVICE_URL, PTD_IDP_URL, and PTD_CONFIG_DIR. Configuration is resolved from environment variables, then the config file, then built-in defaults.

Tools and capabilities

Available MCP operations cover:

  • Sending content to a board.
  • Listing boards and retrieving individual board details.
  • Creating boards and changing their names, descriptions, or layouts.
  • Selecting a default board for updates.
  • Permanently deleting boards.
  • Listing active device connections.

The CLI also provides JSON output for machine-readable workflows, and its send command accepts panel targeting and per-block styling options. These options are relevant when an agent needs to place different content in a multi-panel display rather than overwrite a single undifferentiated message.

Limitations and notes

The material documents authentication through a Push To Display account; it does not describe anonymous access. A device must be connected to receive or show the board update, although the MCP tool list only provides a way to inspect active connections.

The pushtodisplay/cli MCP server is intended for MCP clients with stdio support. The provided setup examples cover Claude Code, Claude Desktop, Cursor, and VS Code with GitHub Copilot; compatibility with other clients depends on their stdio MCP support. Deleting a board is described as permanent, so agents should treat that operation as destructive.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Cli

Use Node.js 18 or newer and run `npx pushtodisplay mcp` in an MCP client configuration. The CLI can also be installed globally with `npm install -g pushtodisplay`.

Yes. Add a stdio MCP entry that runs `npx pushtodisplay mcp` to the Claude Desktop configuration file.

Log in with a Push To Display account using the CLI's browser login or device-code login. The MCP server inherits the stored CLI session.

Yes. The underlying send capability supports panel targeting, full-panel display, spacing density, and horizontal or vertical alignment options.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCli AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/pushtodisplay-cli?style=directory)](https://allmcps.com/mcp/pushtodisplay-cli)
HTML Embed
<a href="https://allmcps.com/mcp/pushtodisplay-cli"><img src="https://allmcps.com/api/badge/pushtodisplay-cli?style=directory" alt="Cli on AllMCPs" /></a>