mcpField
T
Twitch Chat and Stream Management Server

Twitch Chat and Stream Management Server

Local
github.com/Eclipse-XVAI & Agents4Updated 62w ago
Repository

About Twitch Chat and Stream Management Server

Twitch Chat and Stream Management Server is an MCP server for AI systems that interact with Twitch chats and streams. It combines chat analysis and moderation with tools for polls, predictions, clips, and stream metadata updates.

Key features

  1. 01Send messages and retrieve recent chat
  2. 02Analyze chat topics and activity
  3. 03Create polls, predictions, and clips
  4. 04Update stream title and category
  5. 05Timeout or ban users with user resolution

Use cases

  1. 01Post messages or review recent chat during a stream
  2. 02Create viewer polls or predictions
  3. 03Moderate users based on chat context
  4. 04Update stream details or create a clip

MCP support

Exposes Twitch chat, moderation, and stream-management tools to MCP clients, including sending messages, creating polls and clips, and updating stream details.

#twitch#streaming

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Twitch MCP Server

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

For Streamers

  • Use this server via Smithery → Cursor (no local install needed)
  • Quick setup guide: video-guide/final-setup-guide.md
  • Smithery server page (Playground + one‑click add to Cursor): https://smithery.ai/server/@Eclipse-XV/twitch-mcp-smithery
  • Recommended first tests:
    • "Send a message to chat: Hello from MCP!"
    • "Create a poll titled 'Which map?' with choices 'A, B' for 60 seconds"

Note: Actions run as your broadcaster account. Test in Smithery Playground first, then use the Connect section to one‑click add to Cursor and approve.

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
  1. Clone this repository
  2. Install dependencies: 
    npm install
Configuration

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

ParameterDescription
twitchClientIdYour Twitch application client ID
twitchAuthTokenOAuth token (without 'oauth:' prefix)
twitchBroadcasterIdYour Twitch user ID
twitchChannelYour Twitch channel name

Deployment on Smithery

This server is configured for easy deployment on Smithery.

  1. Push this repository to GitHub
  2. Connect your GitHub account to Smithery
  3. Create a new deployment, selecting this repository
  4. 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:

  1. An exact username
  2. A behavioral descriptor (e.g., "toxic", "spam")
  3. 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)

Known Issues & Limitations

Image Description Support

While AI assistants (like Cursor/Claude) can process and describe images, there are some considerations when using this with the Twitch MCP server:

  • Image processing: Image analysis is handled by the AI client, not the MCP server itself
  • Message length: AI-generated descriptions can be quite long. Twitch chat has a 500 character limit per message
  • Auto-truncation: The sendMessageToChat tool now automatically truncates messages that exceed 500 characters and notifies you when this happens
  • Workaround: For detailed image descriptions, consider asking the AI to provide a shorter summary suitable for chat
Other Considerations
  • API Rate Limits: Twitch API has rate limits that may affect rapid successive calls
  • Permissions: Ensure your Twitch token has the necessary scopes for all desired features
  • Stream Status: Some tools (like creating clips) require an active stream

License

ISC

Credits

Based on the original Java implementation of Twitch-MCP.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.