uc-mcp
A read-only MCP server that lets Claude search and read UnknownCheats through your own logged-in session, with every result dated and age-labelled.
Search UnknownCheats by keyword or quoted phrase, with filters for subforum, date window, sort order, thread vs post results, title-only matching, paging, and row limit.
Read a thread's posts with per-post dates, jump to the newest page with
page="last"or-1, and control per-post character budget.Browse subforums: list every subforum and slug, or list a board's threads newest-activity first.
Fetch any UnknownCheats page as cleaned text as a fallback for pages not covered by structured tools.
Check session health, request budget, and cache state; reload cookies after re-exporting them, or clear the cache.
Operate safely: no posting/writing, refuses account and posting endpoints, pins cookies to unknowncheats.me, and treats forum content as untrusted third-party data.
Shape traffic like a careful human reader with rate limits, jitter, hourly/daily request caps, TLS impersonation, and caching.
Read-only client for vBulletin forums (used against UnknownCheats): keyword search across threads and posts with forum scoping, date windows and sorting, browsing subforum listings and their thread lists, and reading individual thread pages (including jumping to the last page) with each post stamped with its date. Handles vBulletin-specific behaviour such as the 500-result search cap and the 15s search rate limit, and refuses account/posting endpoints.
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., "@uc-mcp search UnknownCheats for recent entity list offsets and list dates"
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.
uc-mcp
Search UnknownCheats from Claude Code, with a date on every result.
A read-only MCP server that gives Claude (or any MCP client) search and thread reading on the UnknownCheats forum through your own logged-in session. It marks every result with its age, because on this forum an old answer is usually a wrong one.
Install · Cookies · Usage · Account safety · Troubleshooting
UC search: "entity list" · threads · sorted newest · 23 total · page 1/2 · 3 threads
now=2026-09-30 12:00Z · all dates UTC · (age) after each date
1. 2026-09-28 (2d) [Coding] Entity list walker for the current build
example-game/2000101-entity-list-walker.html · by carol_sdk · 41 replies, 6.2k views · 3pg
2. 2025-11-02 (10mo) [Question] Entity list pointer changed after update
example-game/2000102-entity-list-pointer-changed.html · by erin · 12 replies, 1.9k views
3. 2019-03-14 (7.5y) [Release] Entity list dumper <- ANCIENT
example-game/2000103-entity-list-dumper.html · by frank · 88 replies, 31k views · 5pgWhy
Public docs on game hacking, anti-cheat and reverse engineering are thin, stale or wrong. The current answers are on UnknownCheats, and a model can't read it without an account. This server lets it read the forum with yours, and puts dates first:
Every row carries a date and an age. Dates are converted to UTC from the forum's own timezone.
Stale content is labelled
<- OLD/<- ANCIENT, with a warning line the model can't skim past. Offsets and signatures die on a game patch; a bypass dies when the anti-cheat ships a detection.Long threads point to their last page. Page 1 of a ten-year thread is usually worthless.
Code blocks survive intact (on this forum the code is the answer), and quote chains collapse to one line.
Output is compact text, not JSON, so results cost fewer tokens.
Related MCP server: squatch-harbor-mcp
Install
You need Python 3.10+, an UnknownCheats account, and Claude Code (or another MCP client).
1. Clone and install
git clone https://github.com/0111-0222/uc-mcp.git
cd uc-mcpWindows (PowerShell):
.\install.ps1macOS / Linux:
./install.shThe script creates .venv, installs the dependencies, creates cookies.json
from the example, and prints the exact command to register the server.
uv sync
cp cookies.example.json cookies.json
claude mcp add --scope user unknowncheats -- uv run --directory "$PWD" server.py2. Copy your cookies
No browser extension needed, the browser's own dev tools have everything.
Open
cookies.jsonin an editor and keep it open.Log into unknowncheats.me in your normal browser.
Press F12, open the Network tab, tick Disable cache and refresh the page.
Scroll to the very top of the request list and click the first entry,
index.php.Under Headers, find Request Headers and switch it to Raw.
Copy the whole
Cookie:line into thecookiefield ofcookies.json.Copy the
User-Agent:line from the same list intouser_agent.
A leading Cookie: or User-Agent: is fine, it gets stripped. If the line
contains a bbpassword=…; entry, delete that part (see the table below).
{
"cookie": "bbsessionhash=…; bbuserid=…; cf_clearance=…; bblastvisit=…",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 …"
}Cookie | Needed | Why |
| yes | The site is behind Cloudflare. It is tied to the IP and User-Agent it was issued to, which is why step 7 matters. |
| yes | Search and most boards require a login. |
| no, delete it | vBulletin's persistent auto-login token. It gives long-lived access to your account, and you don't want that sitting in a file. |
cookies.json is gitignored. To keep it somewhere else, set UC_MCP_COOKIES
to its path.
3. Register with Claude Code
Use the command the install script printed (absolute paths). It looks like:
claude mcp add --scope user unknowncheats -- "/path/to/uc-mcp/.venv/bin/python" "/path/to/uc-mcp/server.py"On Windows the interpreter is .venv\Scripts\python.exe. --scope user makes
the server available in every project. Remove it with
claude mcp remove unknowncheats.
Add this to the client's MCP config (claude_desktop_config.json,
.cursor/mcp.json, …):
{
"mcpServers": {
"unknowncheats": {
"command": "C:\\path\\to\\uc-mcp\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\uc-mcp\\server.py"]
}
}
}4. Check it
Start Claude Code and ask:
call uc_session with reload=True
You should see session : logged in, Cloudflare passed.
Usage
Just ask. The tool descriptions already tell the model to reach for UC on game-hacking, anti-cheat and RE questions:
What's the current way people are getting the entity list in Rust? Only trust stuff from the last 6 months.
Find the canonical thread on manual mapping and summarize the newest page.
List the Valorant subforum and tell me what's active this week.
Tools
Tool | What it does |
| Keyword search. |
| Read a thread's posts. |
| No slug: every subforum and its slug. With a slug: that board's threads. |
| Fallback: any forum page as cleaned text. |
| Session health, request budget, cache. |
Searching well
vBulletin ORs loose terms and stops counting at 500, so extra words widen the search instead of narrowing it. A long natural-language query just returns the forum's newest posts. Measured on one query:
Query | Result |
| 500 (cap). Top hits were about YOLO mouse input and Arduino colorbots |
| 105 threads, every title on topic |
...plus | 23 |
...plus | 2 |
So: one "quoted phrase", mode="threads" with title_only=True first,
forum= to scope it, and post mode only if that finds nothing. A header
reading 500+ (result cap) means the ranking is meaningless, and the tool
says so.
Making it the first stop
To make "check UC first" a hard rule in a project, add this to its
CLAUDE.md:
## Game hacking / anti-cheat / RE questions
Before answering from memory or searching the web, call `uc_search` first.
Public documentation on these topics is thin, stale, or wrong. Check the dates
on what comes back: anything older than a year is reference-only — the method
may hold, the offsets and signatures will not.Account safety
This server uses your logged-in session, so it's built to behave like a careful human reader and to never put the login at risk.
What it will never do
Write anything. No tool can post, reply, rate, report, subscribe or PM. Account and posting endpoints (
login.php,private.php,newreply.php,profile.php,usercp.php,attachment.php, anything carrying asecuritytokenorlogouthash, …) are refused before a request is made.Send your cookies anywhere but unknowncheats.me. Forum posts are attacker-controlled text, and a post can try to talk the model into fetching a link. Every URL is parsed, not string-matched, so look-alikes such as
https://evil.com?.unknowncheats.me/are rejected. The cookies are also pinned to the.unknowncheats.medomain inside curl itself, so even a redirect can't carry them off-site. Both guarantees are covered by tests.Follow instructions from posts. Every result is marked as untrusted third-party data.
How it keeps traffic human-shaped
Control | Value | Why |
Between searches | 17s + up to 2s jitter | The forum enforces 15s between searches and rejects anything faster. |
Between page reads | 4s + jitter | Reads are cheap; paying the search price would make threads unusable. |
Hourly cap | 150 requests | Keeps sustained use from looking like a scraper. |
Daily cap | 1000 requests | Same. |
Jitter | 0–2s random | Exactly periodic requests are a bot signature. |
TLS | Chrome impersonation | Handshake matches a real browser, with your real User-Agent. |
The limits are process-wide, and the last send time is kept on disk, so a new
Claude Code session can't fire straight into the forum's throttle. Pages are
cached in .cache/uc.sqlite3 (threads and searches 15 min, forum listings 10,
the board index 6 hours), and paging a search re-uses its server-side
searchid, so going back to a result costs one cheap read, not a new search.
What's on you
Never share
cookies.json, and never paste it, aCookie:header or a HAR file into an issue, a chat or Discord. Anyone holding it is you on the forum. Everyone who uses this runs it with their own account.Leave
bbpasswordout of the export (see cookies).uc_sessiontells you if it's there.Know the risk. Automated access to a logged-in account always carries some ban risk, and the forum's rules are the forum's call. The limits above are mitigation, not a guarantee. Use it the way you'd read the forum yourself.
Troubleshooting
Symptom | Fix |
|
|
|
|
| The hourly or daily cap was hit. Wait; the message says which. |
| Another search (maybe from your browser) went out less than 15s ago. Retry shortly. |
| Use the URL segment, not the display name. |
| The query saturated. See Searching well. |
Server not showing up in Claude Code | Register with absolute paths, and check with |
How it works
flowchart LR
C[Claude / MCP client] -- stdio --> S[server.py<br/>5 tools]
S --> P[uc_parse<br/>HTML → records]
S --> R[uc_render<br/>records → dated text]
S --> H[uc_http]
H --> G{URL guard<br/>host + endpoint}
G --> L[rate limiter<br/>+ budget]
L --> K[(sqlite cache)]
L --> U[curl_cffi<br/>Chrome TLS] --> F[unknowncheats.me]Three things are load-bearing, each verified against the live site:
curl_cffiwith Chrome impersonation, nothttpxorrequests. The Cloudflare WAF fingerprints the TLS handshake. A plain Python client gets a hard 403 no matter how correct the cookies are.Search is a POST with a
securitytoken. A GET againstsearch.php?do=processdoesn't run a search on this vBulletin. The token is scraped, cached, and refreshed automatically if rejected.Selectors are confirmed against real authenticated HTML. UC runs a vBulletin 3-era template set:
td[id=f<id>]for boards,td[id=td_threadtitle_<tid>]for thread rows,table[id=post<pid>]+div[id=post_message_<pid>]for posts.
File | Role |
The five MCP tools and their argument handling | |
URL guard, cookie jar, rate limiter, budget, sqlite cache | |
vBulletin HTML → threads, posts, search hits | |
Records → compact, dated, staleness-labelled text | |
Forum date formats → UTC, ages, rot tiers |
Configuration
Env var | Default | Purpose |
|
| Where your exported cookies live |
|
| Page cache and request ledger |
Development
pip install -r requirements.txt pytest ruff
pytest # offline: synthetic fixtures + a loopback server, no forum traffic
ruff check .The test suite never touches the forum. Parsers run against hand-written
fixtures that mirror UC's markup, and the cookie-pinning test points both
www.unknowncheats.me and a look-alike host at a local server to check which
one gets the login.
License
MIT. Not affiliated with UnknownCheats. You are responsible for how you use your account.
Available Tools
5 toolsuc_fetchARead-onlyIdempotent
Fetch any UnknownCheats page as cleaned text. Fallback only.
Use when a structured tool returns nothing parsable, or for a page the other tools do not model (member profiles, wiki pages). Requests to any host other than unknowncheats.me are refused, as are account and posting endpoints, so a link quoted inside a forum post cannot redirect this anywhere.
Args: path: path under /forum/ or a full unknowncheats.me URL. chars: output budget.
Inputs: path (required), chars. Returns: result
uc_forumARead-onlyIdempotent
Browse UnknownCheats by subforum.
With no slug, lists every subforum and its slug — call that once to learn which board a game or topic lives in. With a slug, lists that board's threads newest-activity first, each with its last-post date, so you can see at a glance whether a board is alive and what is current on it.
Args: slug: subforum slug, e.g. "rust", "valorant", "anti-cheat-bypass". page: page of the thread list. limit: threads to render.
Inputs: page, slug, limit. Returns: result
uc_searchARead-onlyIdempotent
Search UnknownCheats — the reference source for game hacking, reverse engineering and anti-cheat work.
Reach for this FIRST, before answering from memory or searching the web, whenever the question touches: game cheat/hack development, anti-cheat (EAC, BattlEye, VAC, Vanguard, FACEIT, ACE), memory reading/writing, offsets, signatures/patterns, structs and RE of a specific game, DMA and hardware cheats, hooking, injection, driver and kernel-mode work, Unity and Unreal internals, ESP/aimbot technique, or bypass and detection-vector questions. Public documentation on these topics is thin, stale or wrong; this forum is where the current answers actually are.
Skip it for anything outside that domain — a call costs ~17s.
Args: query: ONE "quoted phrase", or one or two rare words. The engine ORs loose terms and stops counting at 500, so extra words WIDEN the result set and common words like "detection" or "injection" saturate it — a long natural-language query returns the forum's newest posts, not its best ones. Measured: '"manual mapping"' with mode="threads", title_only=True gives 105 on-topic threads; '"manual map" injection detection' gives 500 of nothing. forum: optional subforum slug (e.g. "rust", "anti-cheat-bypass") to scope the search. Get slugs from uc_forum(). Measured on the same query: 105 hits unscoped, 23 in anti-cheat-bypass, 2 in rust. since: any | week | 2weeks | month | 3months | 6months | year. Use a window when the answer must reflect the game's current build — anything older is likely dead on arrival. sort: newest | oldest | replies | views. Newest is the safe default here because this material rots; sort by replies to find the canonical long-running thread on a topic. mode: "posts" returns individual matching posts with a dated snippet — best for a how-do-I question, but it saturates the 500-result cap easily. "threads" returns one row per thread — pair it with title_only for the sharpest results this forum can give. title_only: match thread titles only. The strongest precision lever here by a wide margin. Start with title_only=True, mode="threads"; fall back to post mode only if that finds nothing. page: results page, 20 per page. limit: rows to render from that page.
Inputs: query (required), mode, page, sort, +4 more. Returns: result
uc_sessionARead-onlyIdempotent
Session health, request budget and cache state.
Call with reload=True after re-exporting cookies.json — the cf_clearance cookie is short-lived, so a run of Cloudflare errors is normally fixed by refreshing that file and reloading, with no restart needed.
Inputs: reload, clear_cache. Returns: result
uc_threadARead-onlyIdempotent
Read the posts of one UnknownCheats thread, each stamped with its date.
Args: path: the thread path or full URL exactly as printed by uc_search or uc_forum, e.g. "rust/164256-rust-reversal-structs-offsets.html". page: page number, or "last" / -1 for the newest posts. On a thread that has run for years the last page is usually the only current part — page 1 can be a decade old. chars: per-post character budget before truncation. Raise it when a single post holds the code or structure you actually need.
Inputs: path (required), page, chars. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: session management, search, thread reading, forum browsing, and a fallback fetch. The descriptions explicitly clarify boundaries, such as uc_fetch being a fallback for unmodeled pages. No overlap causes confusion.
All tool names follow a consistent 'uc_' prefix plus a single noun or verb (uc_session, uc_search, uc_thread, uc_forum, uc_fetch). The pattern is predictable and easy to scan.
Five tools are well-scoped for a read-only forum access server. Each tool earns its place: session handling, search, thread reading, forum browsing, and a generic fallback fetch. No bloat or missing essentials.
The surface covers the full read-only lifecycle: authentication/cookie refresh (uc_session), discovery via search (uc_search) and browsing (uc_forum), deep retrieval (uc_thread), and a general fallback (uc_fetch) for unmodeled pages. No obvious gaps for the stated purpose of accessing UnknownCheats content.
Maintenance
Related MCP Connectors
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- FlicenseBqualityDmaintenanceAn MCP server that provides tools for searching and analyzing Claude Code conversation history.84-
- AlicenseAqualityCmaintenanceA local MCP server that indexes and searches your past Claude sessions using SQLite FTS5. No cloud, runs entirely on your machine.3MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables searching Discord messages using Discord's native search API. Designed for use with Claude Code to find project decisions and communications in Discord.MIT
- AlicenseAqualityDmaintenanceMCP server that indexes Claude.ai chats and local Claude Code sessions, enabling semantic and keyword search across all your conversations with Claude.685 PyPI5MIT