MCP Server

Push To Display includes an MCP (Model Context Protocol) server that lets AI agents interact with your display boards directly. If you use Claude Code, Cursor, VS Code with Copilot, or any other MCP-compatible tool, you can give it the ability to push content to your boards, create new boards, manage API keys, and more.

What is MCP?

MCP is a standard protocol that lets AI tools call external services as "tools." When you add Push To Display as an MCP server, your AI agent gets a set of tools it can call — like pushtodisplay_send_update or pushtodisplay_list_boards — without you having to write any code.

Think of it as giving your AI agent a direct line to your display boards.

Quick start

1. Make sure you're logged in

The MCP server uses the same credentials as the CLI. Log in first:

npx pushtodisplay auth login

Or set an API key as an environment variable:

export PTD_API_KEY=pt_your_api_key_here

2. Start the server

npx pushtodisplay mcp

That's it — the server starts and waits for tool calls over stdio.

In practice, you won't run this command yourself. Your AI tool launches it automatically based on its configuration. The next page, Setup, shows how to configure each tool.

What the agent can do

The MCP server exposes 11 tools:

Tool	Description
`pushtodisplay_send_update`	Send content to a board
`pushtodisplay_list_boards`	List all your 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

See Examples for prompts and workflows you can try.

Setup — configure Push To Display in your AI tool
Tools Reference — complete input schemas for all 11 tools