Twitch

A Model Context Protocol (MCP) server that provides tools for interacting with the Twitch API using the Helix API.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mtane0412-twitch-mcp-server": {
      "command": "npx",
      "args": [
        "@mtane0412/twitch-mcp-server"
      ],
      "env": {
        "TWITCH_CLIENT_ID": "YOUR_CLIENT_ID",
        "TWITCH_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

You run a Twitch MCP Server that acts as a bridge to the Twitch Helix API, letting you query channel and stream details, top games, categories, emotes, badges, clips, videos, and more through an MCP client. This server is useful for building dashboards, integrations, or automation that needs live Twitch data via the MCP protocol.

How to use

You connect to the Twitch MCP Server from an MCP client and issue requests to retrieve data such as channel profiles, live stream details, video comments, and global assets. The server exposes a variety of functions that let you discover top games, search channels or games, filter live streams by language or game, and access clips and videos from channels. Use these endpoints to build features like real-time dashboards, moderation tools, or content discovery experiences.

How to install

Prerequisites: ensure you have Node.js v18 or higher installed on your machine.

Install the Twitch MCP Server package using your package manager.

Run the MCP server with a single, explicit command.

Additional setup details

Configure the server by supplying your Twitch API credentials. You will provide a Client ID and Client Secret to enable authenticated requests to Twitch Helix endpoints.

You can either export environment variables in your shell session or place them in a .env file at the project root.

Notes on usage and starting the server

Start the MCP server using the runtime command shown in the installation steps. The server runs as a local MCP process that communicates over stdio with your client.

Security considerations

Keep your Twitch Client Secret secure. Do not commit credentials to source control. Use environment variables or a secrets manager in production.

Available tools

getChannelInfo

Fetches channel profile details including description, creation date, and other metadata.

getStreamInfo

Retrieves current stream data such as title, game, viewer count, and start time.

getTopGames

Returns a list of top games currently popular on Twitch.

searchCategories

Search for games or categories by name to discover relevant content.

searchChannels

Find channels by name or keywords to discover creators.

getLiveStreams

Get live streams with optional filters for game and language.

getGlobalEmotes

Retrieve global emotes available across Twitch.

getGlobalChatBadges

Fetch global chat badges for use in chat integrations.

getUserInfo

Obtain user information for Twitch accounts.

getClips

Get clips from a specified channel.

getChatSettings

Query chat-related settings for a channel.

getVideos

Retrieve videos from a specified channel.

getVideoComments

Get comments from archived videos via GraphQL API.