WEBTOON Reader MCP
Enables searching public WEBTOON listings, reading story metadata, listing episodes with pagination, and opening, scrolling, and screenshotting episodes in a managed Chromium browser.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
WEBTOON Reader MCP
An open-source MCP (Model Context Protocol) server for interacting with WEBTOON through FastMCP and Playwright. It enables AI assistants (Claude, Antigravity, OpenCode, and any MCP-compatible client) to search webtoons, read story metadata, list episodes, and open/scroll/screenshot episodes via a managed Chromium browser — all without bypassing any login, payment, age, regional, or anti-bot restrictions.
Features
🔍 Search public WEBTOON listings by keyword across supported languages
📖 Story metadata — title, author, description, genre, thumbnail
📋 Episode listing with pagination support
🌐 Browser-managed episode viewing using Playwright + Chromium
📸 Viewport screenshots saved locally
↕️ Scroll control (up / down) for the open episode page
🩺 Diagnostics tool to report runtime versions and test connectivity
✅ Fully STDIO-based — compatible with any MCP client
Legal notice: This tool only accesses publicly available pages on
www.webtoons.com. It does not download, cache, or redistribute WEBTOON's copyrighted content. Screenshots are saved locally and are not shared. Use responsibly and in accordance with WEBTOON's Terms of Service.
Related MCP server: Cloudflare Playwright MCP
Requirements
Dependency | Version |
Python | ≥ 3.11 |
fastmcp | ≥ 2.14, < 3 |
playwright | ≥ 1.50, < 2 |
requests | ≥ 2.32, < 3 |
beautifulsoup4 | ≥ 4.12, < 5 |
Installation
1. Clone the repository
git clone https://github.com/abhishekxkumar78-sys/webtoon-reader-mcp.git
cd webtoon-reader-mcp2. Create a virtual environment and install dependencies
# Windows (PowerShell)
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
# macOS / Linux
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt3. Install Playwright's Chromium browser
# Windows
.venv\Scripts\playwright install chromium
# macOS / Linux
.venv/bin/playwright install chromiumRunning the server
Windows (batch file — easiest)
Create a start_server.bat in the project root:
@echo off
setlocal
cd /d "%~dp0"
"%~dp0.venv\Scripts\python.exe" "%~dp0server.py"Then double-click it, or run from PowerShell:
.\start_server.batManual (PowerShell)
.venv\Scripts\python.exe server.pymacOS / Linux
.venv/bin/python server.pyThe server communicates over STDIO (standard input/output). Do not run it in a terminal that prints extra text to stdout, as that will break the MCP protocol framing.
MCP Client Configuration
Antigravity / Gemini
Add to your MCP JSON configuration (replace paths with your actual installation path):
{
"mcpServers": {
"webtoon-reader": {
"command": "/absolute/path/to/webtoon-reader-mcp/.venv/Scripts/python.exe",
"args": ["/absolute/path/to/webtoon-reader-mcp/server.py"]
}
}
}Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"webtoon-reader": {
"command": "/absolute/path/to/webtoon-reader-mcp/.venv/Scripts/python.exe",
"args": ["/absolute/path/to/webtoon-reader-mcp/server.py"]
}
}
}OpenCode
Add to opencode.json:
{
"mcp": {
"webtoon-reader": {
"type": "local",
"command": [
"/absolute/path/to/webtoon-reader-mcp/.venv/Scripts/python.exe",
"/absolute/path/to/webtoon-reader-mcp/server.py"
],
"enabled": true
}
}
}Note for Windows users: Use double backslashes (
\\) or forward slashes (/) in JSON paths.
Available Tools
Tool | Type | Description |
| sync | Search public WEBTOON listings by keyword |
| sync | Read metadata from a WEBTOON story page |
| sync | List episodes for a story with pagination |
| async | Open an episode URL in the managed Chromium browser |
| async | Describe the currently open page |
| async | Scroll the open episode up or down by ~75% of viewport height |
| async | Save a viewport-only PNG screenshot to |
| async | Close the Playwright-managed browser |
| async | Report runtime versions and test a basic navigation |
Tool details
search_webtoons(query, language="en", limit=10)
Searches public WEBTOON listings. language accepts short codes like "en", "fr", "es", "de", "th", "id", "zh-hant", "zh-hans". limit is capped at 50.
get_story_details(story_url)
story_url must be a public https://www.webtoons.com/*/list?title_no=* URL.
list_episodes(story_url, page=1)
Returns an array of episode objects. Use page to paginate.
open_episode(episode_url)
Navigates the managed browser to the given https://www.webtoons.com/*/viewer?* URL. Includes one automatic crash-recovery attempt.
scroll_episode_viewport(direction)
direction is "up" or "down".
screenshot_current_viewport(filename=None)
If filename is omitted, a timestamped name is used. Files are saved to screenshots/ and never overwrite existing files.
diagnose_browser_launch()
Returns python_version, fastmcp_version, playwright_version, browser_version, launch_success, and navigation_success.
Project Structure
webtoon-reader-mcp/
├── server.py # FastMCP server — all 9 MCP tools
├── requirements.txt # Pinned dependency ranges
├── logs/ # Runtime log directory (server.log created on startup)
├── screenshots/ # Viewport screenshots saved by screenshot_current_viewport
├── .gitignore
├── LICENSE # MIT
└── README.mdSecurity & Privacy
Only public
www.webtoons.comURLs are accessed; the URL is validated before every HTTP request and before every Playwright navigation.No login credentials, cookies, or session tokens are stored or transmitted.
Screenshots are saved to your local
screenshots/directory only; they are listed in.gitignoreand are never committed.Logs are written to
logs/server.log(also in.gitignore).The server holds exactly one Chromium browser instance per process lifetime and disposes it cleanly on exit.
Development & Testing
Verify syntax
python -m py_compile server.pySmoke-test the STDIO protocol
You can write a minimal MCP client that sends {"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}} over stdin and reads the response from stdout.
Linting (optional)
pip install ruff
ruff check server.pyContributing
Contributions are welcome! Please follow these guidelines:
Fork the repository and create a feature branch (
git checkout -b feat/my-feature).Keep changes focused — one feature or fix per PR.
Do not commit credentials, API keys,
integration-results.json, or personal config files. The.gitignorealready excludes them.Do not add tools that bypass WEBTOON's access controls (login walls, age gates, regional restrictions).
Run
python -m py_compile server.pybefore opening a PR.Open a GitHub Issue first for significant changes so we can discuss the approach.
Disclaimer
This project is an independent open-source tool and is not affiliated with, endorsed by, or sponsored by WEBTOON or LINE Corporation. WEBTOON® is a registered trademark of WEBTOON Entertainment Inc. All WEBTOON content is the property of its respective creators and publishers. This tool interacts only with publicly accessible pages in the same manner as a web browser.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Web search, data extraction and controlled browser automation for AI assistants via OAuth.
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Web search, browser automation, scraping, crawling and CAPTCHA solving for AI agents.
Web search and page reading for AI agents, including JSON APIs, RSS feeds and YouTube.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control a browser for web automation tasks like navigation, typing, clicking, and taking screenshots.Apache 2.0
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control a browser for web automation tasks such as navigation, typing, clicking, and taking screenshots.Apache 2.0
- AlicenseBqualityCmaintenanceEnables AI assistants to control a real Chromium browser through Playwright, allowing them to navigate pages, click elements, fill forms, extract text or HTML, and capture screenshots in a persistent session.6ISC
- AlicenseBqualityCmaintenanceEnables AI assistants to automate a local background Chromium browser for interactive web tasks, including prompt generation on Google Flow (Veo & Imagen), DOM inspection, clicks, screenshots, and JavaScript evaluation.8MIT