mcp-chzzk
Allows interaction with Naver's Chzzk live-streaming platform, providing tools for channel metadata, live status, search, and VOD lookups.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-chzzk What's the live status of channel '우왁굳'?"
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.
mcp-chzzk
MCP (Model Context Protocol) server for Chzzk, Naver's Korean live-streaming platform.
Exposes Chzzk channel, live, search, and VOD lookups as MCP tools so Claude (or any MCP client) can query them.
⚠️ Chzzk does not publish an official public API. This server calls the same undocumented endpoints the web client uses. They may change without notice.
Tools
Tool | Description |
| Channel metadata (name, follower count, description, verified mark) |
| Live status — is broadcasting, title, category, viewer count, start time |
| Extended live info including 720p thumbnail URL |
| Search channels by keyword |
| Search VOD by keyword |
| Search currently live broadcasts by keyword |
| List currently live broadcasts (popularity order) |
| List recent VOD for a channel |
Channel arguments accept either a 32-hex channel id or a chzzk.naver.com/[live/]<id> URL.
Related MCP server: Naver Search MCP Server
Install & Build
npm install
npm run buildConfiguration
All Chzzk endpoints exposed here are public — no authentication is required.
For private or restricted content (adult-only channels, subscriber views), provide Naver session cookies via env vars:
export CHZZK_NID_AUT="..."
export CHZZK_NID_SES="..."You can extract these from your browser's DevTools → Application → Cookies → naver.com while logged in.
Run
Direct:
node build/index.jsWith MCP Inspector (browser-based debugger):
npm run inspectUse from Claude Code
Add to ~/.claude/settings.json or .mcp.json:
{
"mcpServers": {
"chzzk": {
"command": "node",
"args": ["/absolute/path/to/mcp-chzzk/build/index.js"],
"env": {
"CHZZK_NID_AUT": "",
"CHZZK_NID_SES": ""
}
}
}
}Then in Claude Code, run /mcp to confirm the chzzk server appears and the tools are listed.
References
hacs-chzzk — Home Assistant integration with the verified Chzzk endpoints this server is built on.
twitch-mcp-server — structural reference.
License
MIT
Available Tools
8 toolsget_channelA
Get Chzzk channel metadata: name, image, description, follower count, openLive flag, verified mark.
Inputs: channel (required).
get_channel_videosB
List recent VOD (videos) for a specific Chzzk channel.
Inputs: channel (required), size.
get_live_detailA
Get extended live info including 720p thumbnail URL. Falls back to live status if the channel is offline.
Inputs: channel (required).
get_live_statusA
Get the lightweight live status for a Chzzk channel — whether it is currently broadcasting, title, category, viewer counts, start time.
Inputs: channel (required).
list_livesA
List currently live Chzzk broadcasts, ordered by the platform's popularity ranking.
Inputs: size.
search_channelsB
Search Chzzk channels by CHANNEL NAME. Use this to look up a specific streamer by their handle. Each result includes an openLive flag indicating whether the channel is currently broadcasting — combine with get_live_status / get_live_detail for live info.
Inputs: keyword (required), size.
search_livesA
Search currently live Chzzk broadcasts by LIVE TITLE (the title the streamer set for this broadcast — NOT the channel name). If you want to find a specific streamer by handle, use search_channels instead.
Inputs: keyword (required), size.
search_videosA
Search Chzzk VOD (recorded videos) by VIDEO TITLE / tags. Does NOT search live broadcasts — use search_lives or search_channels for those.
Inputs: keyword (required), size.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct resource or action: channel metadata, videos, live status/detail, live listings, and searches by channel, live title, or video. Even the two live-related tools (get_live_detail and get_live_status) have clearly different levels of detail.
All tool names follow a consistent verb_noun pattern in snake_case: get_channel, get_channel_videos, get_live_detail, get_live_status, list_lives, search_channels, search_lives, search_videos. Verbs are uniform (get, list, search).
8 tools cover the core read operations for the Chzzk streaming platform: channel info, VODs, live status/detail, and three search entry points. This is a well-scoped set without bloat.
The tool surface covers essential read operations for channels, videos, and live broadcasts. A minor gap is the lack of a dedicated tool to retrieve a single VOD by ID, though get_channel_videos and search_videos provide access. Overall, it supports common agent workflows without dead ends.
Maintenance
Related MCP Connectors
Query your Twitch streams, events, supporters, raids & rankings from an AI assistant via OAuth.
Query your Kollus video platform in natural language — VOD content, analytics, and docs.
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
YouTube search, whole channels, video stats, comments and full transcripts with timestamps.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with the Twitch API, allowing users to retrieve comprehensive information about channels, streams, games, and more, with additional support for searching and accessing chat elements like emotes and badges.14219 npm4MIT
- AlicenseAqualityDmaintenanceProvides access to Naver Search APIs, allowing AI agents to search across multiple categories (blogs, news, books, images, shopping items, etc.) with structured responses optimized for LLM consumption.134Apache 2.0
- -licenseNot gradedqualityNot gradedmaintenanceEnables access to Twitch API data for retrieving channel statistics, viewership information, stream status, and discovering channels and game categories. Provides real-time Twitch data including follower counts, current viewer numbers, and search functionality through natural language interactions.-
- FlicenseAqualityDmaintenanceEnables interaction with the Twitch API to retrieve user information, check live status, access videos, top streams, games, and search channels through natural language.10-