@gibeon/mcp-server

MCP server for the Gibeon digital signage platform. Control your players, manage playlists, and trigger publishes from Claude Desktop, Cursor, Claude Code, or any other MCP-aware client.

---

You probably want the hosted MCP instead.

https://api.gibeon.io/mcp runs the same 13 tools without any install, updates instantly, and survives npx cache invalidations. This npm package is a compatibility shim for MCP hosts that do not yet support remote/HTTP transports. See hosted config below.

---

Hosted (recommended)

{
  "mcpServers": {
    "gibeon": {
      "url": "https://api.gibeon.io/mcp",
      "headers": {
        "Authorization": "Bearer gib_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Works in Claude Desktop, Claude Code, and Cursor.

npm (compatibility shim)

For MCP hosts without remote-transport support, run the same surface as a local stdio process:

npx -y @gibeon/mcp-server
# (waits on stdin — correct, your MCP client speaks to it that way)

Configure your host to launch it:

{
  "mcpServers": {
    "gibeon": {
      "command": "npx",
      "args": ["-y", "@gibeon/mcp-server"],
      "env": {
        "GIBEON_API_KEY": "gib_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

API key

Create one in the Gibeon CMS at Settings → API → New key and copy the gib_live_… value. The full token is shown once at creation.

Tools in v0.2.0 (13 total)

Players + publish

Tool	What it does
list_players	List the screens in your tenant, optionally filtered by status/group.
get_player	Fetch one player by id.
update_player	Rename, reassign content, change orientation. Returns publish_required.
publish_players	Build a fresh snapshot for one player or every player in the tenant.

Playlists + items

Tool	What it does
list_playlists	List the playlists in your tenant.
get_playlist	Fetch one playlist, optionally with its content items inline.
create_playlist	Create a new empty playlist.
update_playlist	Rename, change default interval, swap cover image.
delete_playlist	Permanently delete a playlist and its items.
add_playlist_item	Append an image / video / image slideshow / YouTube embed to a playlist.
update_playlist_item	Patch an existing item's name / duration / schedule / asset / config.
delete_playlist_item	Remove a single item from a playlist.
reorder_playlist_items	Set the full playback order in one call.

Example prompts

"How many players are online in my Gibeon tenant?" → calls list_players with status: "online".

"Create a playlist called Lobby Morning, add the welcome image, then point screen 7f3a… at it and republish." → create_playlist + add_playlist_item + update_player + publish_players.

Env reference

Var	Required	Default	Notes
GIBEON_API_KEY	yes	—	Must start with gib_.
GIBEON_API_TIMEOUT_MS	no	15000	Per-call timeout in ms.

Links

• Docs: https://www.gibeon.io/dev

License

MIT