# Twitch MCP

> Twitch MCP Server connects your AI client to all core Twitch metrics. You can audit live streams, check follower counts, search channels, and retrieve top clips—all through natural conversation. It lets you build a real-time channel coordinator right into your agent's workflow.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** live-streaming, channel-management, audience-analytics, clips, creator-tools

## Description

Your agent connects to Twitch’s entire data pool, letting you audit everything from live viewership counts to deep user metrics without ever touching a dashboard. You get access to core tools that handle complex queries across followers, streams, clips, and profiles.

**Auditing Live Streams & Platform Trends**

You can immediately list all current **live streams**, getting real-time viewer counts and the specific game each channel's playing using `get_streams`. Want to know what’s hot right now? Use `get_top_games` to pull a list of the top trending games being streamed. You can narrow down your live stream search by filtering for a specific game title or even searching directly by username. This server lets you track major platform movements, providing the necessary data points to understand current viewer interest.

**Analyzing Follower and Subscriber Bases**

Need to audit an account’s reach? Your agent can use `get_channel_followers` to retrieve the total follower count for any channel. Beyond just raw numbers, you'll get subscription details using `get_subscriptions`, letting you understand revenue streams for a broadcaster. You also track who your network follows; running `get_followed_channels` gives you the full list of channels that a specific user is tracking. For deep profile research, you can run `get_users` on any specified Twitch user ID or username to retrieve detailed profile information, and you'll use `get_channel_info` to fetch comprehensive metadata about an entire channel.

**Curating Content and Discovering Users**

You don’t just check live stats; you build a full content library. You can find top highlight clips for any broadcaster using `get_clips`, plus you'll get a list of archived video content posted by that user via `get_videos`. To find specific people or channels, use `search_channels` to search the entire platform based on keywords, names, or categories. If you know who you're looking for, running `get_users` lets you pull detailed profile information regardless of whether they are a major streamer or just some random user.

**How It Works With Your AI Client**

Your agent stitches it all together. You tell your client to find the top five trending games and then locate three streamers in those categories who have over ten thousand followers; the agent handles that complex query stitching instantly across `get_top_games`, `get_streams`, and `get_channel_followers` so you never manually navigate an API endpoint. It gives you a real-time channel coordinator right inside your workflow.

**Key Tool Functions:**
*   Use `get_streams` to list all currently live streams, including viewer counts and game details.
*   Run `get_channel_followers` to get the total follower count for any single Twitch channel.
*   Get detailed account information using `get_users`, which pulls full profile data for a given ID or name.
*   Search across the platform with `search_channels` by keywords, names, or categories. 
*   Pull historical content and highlights with `get_clips` and `get_videos` for any specified broadcaster.
*   Track user allegiance by using `get_followed_channels` to see which channels a specific account follows.

## Tools

### get_channel_followers
Retrieves the total number of followers for a specific Twitch channel.

### get_channel_info
Fetches detailed information and metadata about a given Twitch channel.

### get_clips
Gets a list of recorded highlight clips for any specified broadcaster.

### get_followed_channels
Returns the list of channels that a specific user is following.

### get_streams
Lists currently live streams, including viewer counts and game details.

### get_subscriptions
Retrieves subscription data for a specific broadcaster's channel.

### get_top_games
Lists the top trending games currently being streamed on Twitch.

### get_users
Retrieves detailed profile information for any specified Twitch user ID or username.

### get_videos
Fetches a list of archived video content posted by a specific user.

### search_channels
Searches for Twitch channels based on keywords, names, or categories.

## Prompt Examples

**Prompt:** 
```
Check if user 'ninja' is currently live on Twitch.
```

**Response:** 
```
Checking status... Yes, 'Ninja' is currently live! He is streaming 'Fortnite' to 15,000 viewers. Would you like the stream link?
```

**Prompt:** 
```
Show me the top 5 games on Twitch right now.
```

**Response:** 
```
The top 5 games currently are: 'Just Chatting', 'League of Legends', 'Grand Theft Auto V', 'VALORANT', and 'Counter-Strike'. Which game would you like to see live streams for?
```

**Prompt:** 
```
List the last 5 videos for broadcaster ID 12345.
```

**Response:** 
```
I've retrieved the recent videos for ID 12345. You have 5 archives, including 'Tuesday Night Chill' and 'Ranked Climb'. Would you like the duration and view count for any of them?
```

## Capabilities

### Audit Live Streams
List all current live streams, filtering by game title or user name, and retrieve viewer counts.

### Analyze Follower Base
Check the total follower count for any channel, query moderator lists, or verify subscriber details.

### Curate Content Clips
Retrieve top highlight clips and video archives for a specified broadcaster's ID.

### Search Channels & Users
Find channels or users by name, or get detailed metadata on any Twitch user profile.

### Track Platform Trends
Identify the currently most popular games and list live streams across major categories.

## Use Cases

### Checking a Competitor's Live Status
A marketing manager needs to know if a competitor is live right now. They ask their agent: 'Check the status for user X.' The agent runs `get_streams` and immediately reports back on viewer count and game title, without needing to visit Twitch or use any dashboard.

### Auditing Follower Growth After a Campaign
A creator wants to know if their last effort paid off. They ask the agent: 'What was our follower count before and now?' The agent runs `get_channel_followers` twice, comparing data points efficiently to give an immediate growth metric.

### Researching a New Content Niche
A content strategist needs ideas. They ask the agent: 'What are the top 5 games right now?' The agent runs `get_top_games`, giving them five actionable titles to base their next stream around, and they can follow up with `search_channels` for examples.

### Gathering Background on a Partner Streamer
An operations lead needs context on a potential partner. They ask the agent: 'Give me everything I can find on user Y.' The agent runs `get_channel_info` and `get_users`, pulling together metadata, video archives (`get_videos`), and basic profile details in one go.

## Benefits

- Track real-time audience health. Use `get_streams` to see live viewer counts or `get_channel_followers` to check total growth at a glance.
- Keep content organized with minimal effort. Running `get_clips` gives you top highlights, while `get_videos` archives all past uploads for review.
- Monitor the community without logging in. Quickly audit moderator lists and subscriber totals using `get_subscriptions`.
- Stay ahead of trends. Run `get_top_games` to see what's hot right now, then use `search_channels` to find creators in those niches.
- Get full user context. Use `get_users` or `get_channel_info` to retrieve detailed metadata for any account, making cross-functional auditing simple.

## How It Works

The bottom line is you tell your AI client what you want, and it runs the necessary Twitch API calls behind the scenes until it has everything you asked for.

1. Subscribe to the Twitch MCP Server and provide your Client ID and Access Token.
2. Tell your AI client what data you need (e.g., 'Find top games and check follower count for channel X').
3. Your agent uses the necessary tools (`get_top_games`, `get_channel_followers`) to gather all required data points and synthesizes a single answer.

## Frequently Asked Questions

**How do I use get_channel_followers to see follower data?**
You pass the channel ID or username to the `get_channel_followers` tool. The agent returns a single, current number representing the total following count for that account.

**Can I use get_top_games to find trending content?**
Yes, `get_top_games` lists currently popular games on Twitch. You can then feed those game titles into a tool like `get_streams` to see which specific channels are live in that category.

**What is the difference between get_videos and get_clips?**
`get_videos` pulls archived, full-length VODs uploaded by a user. `get_clips`, however, retrieves short, curated highlight segments specifically marked as top moments.

**How do I search for channels using the search_channels tool?**
You pass keywords or category names to `search_channels`. The agent returns a list of matching channel profiles which you can then use other tools on (like `get_channel_info`).

**What credentials do I need to use tools like get_channel_info?**
You must provide a valid Twitch Client ID and an Access Token. These are passed as environment variables or context parameters with your AI client call. The server uses these tokens to authenticate all requests, ensuring you only access data for authorized accounts.

**How does the get_subscriptions tool track paid memberships?**
It returns a list of current subscribers and their specific subscription details. You'll see the user ID, the date they subscribed, and the tier level (e.g., Tier 1, Tier 2) for accurate monitoring.

**What kind of metrics does get_streams provide for live channels?**
It lists all currently active streams by status, viewer count, and game title. This allows your agent to quickly audit who is streaming right now and how many people are watching them.

**How do I use get_followed_channels to see user activity?**
This tool pulls a complete list of channel IDs that a specific user has favorited. It's useful for tracking the overall viewing interests and network connections of an individual account.

**How do I find my Twitch Client ID and Access Token?**
Go to the [**Twitch Developer Console**](https://dev.twitch.tv/console), create an App, and generate a Client Secret to get an App Access Token or perform the OAuth flow for a User Token. Copy and paste them below.

**Can the agent check if a channel is live?**
Yes. Use the `get_streams` tool providing the user login. Your agent will return real-time status, including viewer count and game title if the channel is live.

**Is it possible to list top clips via the agent?**
Yes. The `get_clips` tool allows your agent to retrieve the most popular clips for a specific broadcaster, helping you identify trending content moments.