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.

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

• hacs-chzzk — Home Assistant integration with the verified Chzzk endpoints this server is built on.
• @modelcontextprotocol/sdk
• twitch-mcp-server — structural reference.

License

MIT