# Control SignageSpace from ChatGPT, Claude, and other AI assistants

> Connect SignageSpace to ChatGPT, Claude, Cursor, or any MCP client. Ask an AI assistant what is playing, build playlists, and cast content to your screens. Free on every plan.

Source: https://signagespace.com/ai/

## MCP server

SignageSpace runs a Model Context Protocol server at `https://app.signagespace.com/mcp` (streamable HTTP).

Add it as a custom connector or remote MCP server in any MCP-capable client and sign in with a SignageSpace account. It is included on every plan, the free one included, and needs no API key.

## Read tools

- `list_screens` — Every paired screen, whether it is online, and what it is playing right now.
- `get_screen` — Full detail for one screen — platform, orientation, license, assigned content.
- `list_playlists` — The playlists in the account, with their items and durations.
- `list_channels` — Channels — multi-zone layouts with their scheduling rules.
- `list_content` — The media library: uploaded images and videos with ids to reference.
- `get_account` — Your plan and how much of it is used — screens, storage, upload cap — so the assistant knows the limits.

Granted by the `novasign.read` scope.

## Write tools

- `pair_screen` — Add a new screen by reading out the pairing code the player app shows on the TV.
- `upload_image` — Pull an image from a URL straight into the media library — including one the AI just generated.
- `create_playlist` — Build a new playlist from media or canvas layouts, in the order you describe.
- `update_playlist` — Rename a playlist or change its items, durations, and order.
- `cast_to_screen` — Put a playlist, channel, or layout on a screen — or clear it.
- `reload_screen` — Force a screen to refresh its content immediately.

Granted by the `novasign.write` scope, which can be withheld for a read-only connection.

## Connecting a client

### Claude (web, desktop & mobile)

1. Open Settings → Connectors → Add custom connector.
2. Paste https://app.signagespace.com/mcp as the server URL and save.
3. Click Connect, sign in with your SignageSpace account, and approve the permissions you want to grant.

### ChatGPT

1. Open Settings → Connectors and add a new MCP connector.
2. Enter https://app.signagespace.com/mcp as the server URL.
3. Complete the SignageSpace sign-in when ChatGPT opens the authorization window.

### Claude Code

1. Run the command below, then use /mcp in any session to finish signing in.

```
claude mcp add --transport http signagespace https://app.signagespace.com/mcp
```

### Cursor, Windsurf & other MCP clients

1. Add the server to your MCP configuration file. Authentication is handled in-app on first use.

```
{
  "mcpServers": {
    "signagespace": {
      "url": "https://app.signagespace.com/mcp"
    }
  }
}
```

## Example requests

- "The TV is showing code 4821 — add it as the Lobby screen."
- "Which of my screens are offline right now?"
- "Show me what is playing on the lobby screen."
- "Build a playlist from my four newest product photos, 10 seconds each, and put it on the storefront TV."
- "Generate a "Closed for the holiday" notice, upload it, and cast it to every screen."
- "Swap the café screen back to the regular menu channel and reload it."

## Security model

- OAuth 2.1 with PKCE and dynamic client registration — the assistant never receives a password.
- Read and write scopes are approved separately on a consent screen.
- Every tool call is scoped to the signed-in user and re-applies the same ownership and plan checks as the dashboard.
- Tool traffic is rate limited per user, and access can be revoked at any time.

## Machine-readable entry points

- **MCP server** — `https://app.signagespace.com/mcp` — Streamable HTTP. The way an agent reads and changes an account.
- **OAuth 2.1 metadata** — `https://app.signagespace.com/.well-known/oauth-authorization-server` — RFC 8414 discovery — authorize, token, and dynamic client registration endpoints.
- **Public REST API** — `https://app.signagespace.com/api/openapi.json` — OpenAPI 3.1 for the credential-free endpoints: blog, app catalog, templates, downloads.

## Questions

**What is the SignageSpace MCP server URL?**

https://app.signagespace.com/mcp — add it as a custom connector or remote MCP server in your AI client, then sign in with your SignageSpace account.

**Which AI assistants can control SignageSpace?**

Any client that speaks the Model Context Protocol over streamable HTTP. That includes Claude, ChatGPT, Claude Code, Cursor, and Windsurf. SignageSpace implements the standard OAuth 2.1 flow those clients expect, so no API keys are copied by hand.

**Does the AI integration cost extra?**

No. The MCP server is included with every SignageSpace account, free plan included. Your plan limits still apply — a Basic account can drive its one screen through an assistant exactly as it can through the dashboard.

**What can an AI assistant actually change on my screens?**

It can read your screens, playlists, channels, and media library, and — when you grant write access — upload images, create or update playlists, cast content to a screen, and reload a screen. It cannot touch billing, delete your account, or reach another customer’s data.

**Is it safe to connect an AI assistant to my digital signage?**

Connections use OAuth 2.1 with PKCE, so the assistant never sees your password. You approve read and write scopes separately on a consent screen, every tool call is scoped to your own account, and requests are rate limited so a runaway agent cannot flood your screens. Revoke access any time from your SignageSpace account.

**Can an AI assistant set up a screen from scratch?**

Yes, once the player app is installed on the TV. The app shows a pairing code; read it out to the assistant and it can claim the screen, name it, upload media, build a playlist, and put it on air without you opening the dashboard. Installing the player on the device is the one step that stays manual.