Skip to main content
Glama
mcp-chzzk
by saya6k

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

get_channel

Channel metadata (name, follower count, description, verified mark)

get_live_status

Live status — is broadcasting, title, category, viewer count, start time

get_live_detail

Extended live info including 720p thumbnail URL

search_channels

Search channels by keyword

search_videos

Search VOD by keyword

search_lives

Search currently live broadcasts by keyword

list_lives

List currently live broadcasts (popularity order)

get_channel_videos

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 build

Configuration

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.js

With MCP Inspector (browser-based debugger):

npm run inspect

Use 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

License

MIT

Available Tools

8 tools
get_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

    A4/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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).

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      14
      219 npm
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      13
      4
      Apache 2.0
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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.
      -