How do I use nightbot-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@nightbot-mcp Add the word 'spam' to the blacklist." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

nightbot-mcp

by aaronckj

Overview Schema Related Servers Score Discussions

Python

Remote

nightbot-mcp

An MCP (Model Context Protocol) server for Nightbot: manage custom chat commands, timers, regulars, and spam-protection filters — including the blacklist (banned words/phrases for live chat) — through the official Nightbot API.

Every mutating tool accepts dry_run=true and returns a preview.
add_banned_phrases appends to the blacklist without clobbering it (fetch → merge → update).
No secrets in this repo or logged at runtime.

Quick start

Create an app at nightbot.tv/account/applications and generate an access token (scopes: channel commands timers regulars spam_protection channel_send).
Provide the token:

export NIGHTBOT_ACCESS_TOKEN=...     # or NIGHTBOT_MCP_SECRETS=vaultproxy

Add to your MCP client:

# Claude Code
claude mcp add nightbot -s user -- uvx nightbot-mcp

Related MCP server: Discord MCP Server

Tools

Area	Tools
Channel	`channel_info`, `join_channel`, `part_channel`, `send_chat_message`
Commands	`list_commands`, `add_command`, `update_command`, `delete_command`
Timers	`list_timers`, `add_timer`, `toggle_timer`, `delete_timer`
Regulars	`list_regulars`, `add_regular`, `remove_regular`
Spam protection	`get_spam_filter`, `update_spam_filter`, `add_banned_phrases`
Meta	`health_check`

Filters: blacklist, links, caps, symbols, repetitions, emotes. Blacklist entries support Nightbot's * wildcards.

Development

pip install -e '.[dev]'
ruff check src tests && pytest

Tests are fully offline (fake HTTP opener).

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

View all tools

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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