Skip to main content
Glama
gibeon-io

@gibeon/mcp-server

Official
by gibeon-io

@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.


{
  "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.

License

MIT

A
license - permissive license
-
quality - not tested
-
maintenance - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

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/gibeon-io/mcp-server'

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