Skip to main content
Glama
amaralkaff

UnknownCheats MCP

by amaralkaff
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

mcp-unknowncheat

An MCP (Model Context Protocol) server for programmatically interacting with the UnknownCheats forum. Bypasses Cloudflare protection using a real Chrome instance and provides structured data extraction via Cheerio.

Features

  • Cloudflare bypass — Uses puppeteer-real-browser with a headed Chrome instance to solve Turnstile challenges automatically

  • Cookie persistence — Session cookies saved to cookies.json and reused across restarts

  • Auto-recovery — Detects detached frame / browser crash errors and relaunches automatically

  • 5 MCP tools — Login, search, thread reading, pagination, and code extraction

Tools

Tool

Description

Parameters

check_login

Check if the browser session is logged in

—

login

Auto-fill credentials and log in

username, password

search_forum

Search UC or browse a subforum

query, subforum?

get_thread

Fetch thread posts with pagination

url, fetch_all_pages?

extract_code

Extract C++/C#/Python/Lua code blocks

url

Stack

Requirements

  • Bun v1.0+

  • Google Chrome installed (required by puppeteer-real-browser)

Installation

git clone https://github.com/amaralkaff/mcp-unknowncheat.git
cd mcp-unknowncheat
bun install

Setup with Claude Code

claude mcp add uc-mcp bun -- run "/path/to/mcp-unknowncheat/src/index.ts"

Setup with Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "uc-mcp": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-unknowncheat/src/index.ts"]
    }
  }
}

Usage

On first run, Chrome opens in headed mode. Log in manually or use the login tool:

login({ username: "your_username", password: "your_password" })

Cookies are saved automatically. Subsequent runs reuse the session.

Examples

# Check login status
check_login()

# Browse the Apex Legends subforum
search_forum({ subforum: "apex-legends" })

# Search across all forums
search_forum({ query: "pubg offsets" })

# Get a thread (single page)
get_thread({ url: "https://www.unknowncheats.me/forum/..." })

# Get all pages of a thread
get_thread({ url: "https://www.unknowncheats.me/forum/...", fetch_all_pages: true })

# Extract code blocks with language detection
extract_code({ url: "https://www.unknowncheats.me/forum/..." })

Project Structure

src/
├── index.ts          # MCP server entry + tool registration
├── browser.ts        # Chrome lifecycle, Cloudflare bypass, cookie persistence
├── types.ts          # Shared TypeScript interfaces
├── tools/
│   ├── check-login.ts
│   ├── login.ts
│   ├── search-forum.ts
│   ├── get-thread.ts
│   ├── extract-code.ts
│   └── debug-page.ts
└── parsers/
    ├── thread.ts         # Post extraction, pagination
    ├── search-results.ts # Search result parsing
    ├── code-blocks.ts    # Code extraction + language detection
    └── tags.ts           # Thread tag detection ([Source], [Release], etc.)

Notes

  • All logging uses console.error() — console.log() is reserved for the MCP stdio transport

  • Thread pagination capped at 50 pages by default for fetch_all_pages

  • Language detection supports: C++, C#, Python, Lua

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/amaralkaff/mcp-unknowncheat'

If you have feedback or need assistance with the MCP directory API, please join our Discord server