Twitch-MCP-Smithery

Twitch MCP Server

A comprehensive Twitch MCP (Model Context Protocol) server providing chat moderation, stream management, and Twitch API integration for AI systems.

Overview

This MCP server allows AI agents to interact with Twitch streams through a standardized set of tools. It supports:

Sending messages to chat
Creating polls and predictions
Generating clips
Analyzing chat for trends and topics
Moderating chat (timeout/ban users)
Updating stream title and category

Getting Started

Prerequisites

Node.js 18+ installed
Twitch API credentials (Client ID and OAuth token)
Twitch channel with appropriate permissions

Installation

Clone this repository
Install dependencies:
npm install

Configuration

You need to provide Twitch API credentials when connecting to the server. The following configuration options are required:

Parameter	Description
`twitchClientId`	Your Twitch application client ID
`twitchAuthToken`	OAuth token (without 'oauth:' prefix)
`twitchBroadcasterId`	Your Twitch user ID
`twitchChannel`	Your Twitch channel name

Deployment on Smithery

This server is configured for easy deployment on Smithery.

Push this repository to GitHub
Connect your GitHub account to Smithery
Create a new deployment, selecting this repository
Configure your Twitch API credentials in the Smithery dashboard

Available Tools

Chat Interaction

sendMessageToChat: Send a message to Twitch chat
getRecentChatLog: Get the last 20 chat messages for context
analyzeChat: Analyze chat for topics and activity

Stream Management

createTwitchPoll: Create a poll with multiple choices
createTwitchPrediction: Create a prediction with outcomes
createTwitchClip: Create a clip of the current stream
updateStreamTitle: Change the stream title
updateStreamCategory: Change the game/category

Moderation

timeoutUser: Timeout a user for a specified duration
banUser: Permanently ban a user from chat

Advanced Features

Smart User Resolution

When performing moderation actions, you can provide either:

An exact username
A behavioral descriptor (e.g., "toxic", "spam")
A partial username match

The server will attempt to resolve the appropriate user based on chat history.

Intelligent Timeout Duration

The timeout tool automatically suggests an appropriate duration based on the severity of the provided reason:

Spam/excessive emotes: 5 minutes
Toxic behavior: 30 minutes
Severe violations: 60 minutes
Other violations: 10 minutes (default)

License

ISC

Credits

Based on the original Java implementation of Twitch-MCP.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.