Skip to main content
Glama
aaronckj

nightbot-mcp

by aaronckj

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NIGHTBOT_MCP_SECRETSNoAlternative to NIGHTBOT_ACCESS_TOKEN: set to 'vaultproxy' to use a proxy for secrets
NIGHTBOT_ACCESS_TOKENNoNightbot access token with scopes: channel commands timers regulars spam_protection channel_send

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
channel_infoB

The Nightbot channel this token controls, and whether the bot has joined.

join_channelC

Make Nightbot join the channel's chat.

part_channelC

Make Nightbot leave the channel's chat.

list_commandsB

List custom chat commands.

add_commandB

Add a custom command (name like !rules). user_level: everyone|subscriber|regular|moderator|owner. cooldown in seconds (5-300).

update_commandC

Update a custom command's message, user level, or cooldown.

delete_commandC

Delete a custom command.

list_timersA

List timers (scheduled recurring chat messages).

add_timerA

Add a timer that posts a message every interval_minutes (5-60) once chat_lines messages have passed (spam guard).

toggle_timerC

Enable or disable a timer.

delete_timerC

Delete a timer.

list_regularsA

List regulars (trusted users exempt from spam filters).

add_regularC

Add a user to regulars by username.

remove_regularB

Remove a regular by id (from list_regulars).

get_spam_filterA

Get a spam-protection filter's settings. filter_name: blacklist|links|caps|symbols|repetitions|emotes. blacklist = the banned words/phrases list for live chat.

update_spam_filterC

Update a spam filter. For filter_name=blacklist, blacklist replaces the banned words/phrases list (supports * wildcards per Nightbot docs).

add_banned_phrasesA

Append phrases to the chat blacklist (fetch-merge-update; no duplicates).

list_default_commandsA

List Nightbot's built-in commands (!commands, !title, etc.) and status.

toggle_default_commandB

Enable or disable a built-in command by name (e.g. 'songs', 'title').

song_requests_settingsC

Get song-request settings, or update them when arguments are given. playlist: monstercat|youtube|soundcloud (provider-dependent).

song_queueB

List the current song-request queue.

song_skipC

Skip the currently playing song request.

song_queue_clearC

Clear the entire song-request queue.

send_chat_messageC

Send a chat message as Nightbot.

health_checkA

Verify the Nightbot token and report the connected channel.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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/aaronckj/nightbot-mcp'

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