1. Create or sign into an account
The portal account lets you approve Codex devices, view synced progress, manage billing, and use referral crew features. Password accounts must verify email before sync or device approval.
Player guide
MCP Miner Instructions
MCP Miner is a local-first idle mining game for Codex. You work normally, MCP Miner converts only privacy-safe abstract work events into game progress, and the portal shows your synced progress when you choose to link an account.
First run
Set up your charter before you mine in the cloud.
2. Name your Space charter
Your space charter name is a two-word first-and-last style name, such as Buck Manwood. It is intentionally locked after setup so the game can treat it like a persistent captain identity.
3. Name your mining LSLC
Your mining outfit is a Limited Space Liability Company. If you leave off LSLC, the portal adds it. The company name is used for claim labels and profile identity.
4. Install and link Codex
Copy the OS install prompt, restart Codex, trust the MCP Miner hooks, start an account link from Codex, approve the short-lived code in the portal, then complete cloud sync from Codex.
Gameplay
What all the numbers mean.
Suit %
Suit percentage is your miner's condition. Normal work can expose you to asteroid hazards, and hazards can lower suit condition. Keep an eye on it as harder asteroid classes become available.
Chonks
Chonks are the starter material bucket mined from supported work events. They can be refined, sold, or used to fulfill orders depending on the current economy and recipes.
Space Bucks
Space Bucks are earned by fulfilling orders, selling materials, completing contracts, or receiving approved rewards. They buy upgrades, store items, base modules, and future unlocks.
Asteroid progress
Each asteroid claim has a depletion size. Synced progress shows mined amount, percent complete, the current rock class, rare-find chance, work score, last event number, and linked devices.
Materials and inventory
Inventory tracks raw, refined, fabricated, and special materials. The portal only shows game inventory, not private work artifacts. Material values are used by orders, store decisions, and summaries.
Orders and upgrades
Orders consume materials and pay Space Bucks. Upgrades improve mining, rewards, protection, or automation paths. A good loop is status, refine useful materials, fulfill ready orders, then buy the best affordable upgrade.
Portal and sync
Cloud sync mirrors abstract game state.
What sync sends
Sync sends abstract reward events, sequence numbers, checksums, totals, inventory, orders, upgrades, asteroid progress, reports, and device metadata needed to render the portal.
What sync never sends
MCP Miner does not sync prompts, chat transcripts, source code, file paths, repo names, terminal output, browser content, app content, OpenAI account data, or raw private work artifacts.
Devices
Each Codex device gets a revocable local token after you approve a short-lived link code. Free accounts support one Codex device; Pro supports more devices and faster sync cadence.
Reports
Reports are compact game summaries generated from abstract state. They are designed to be safe to show in Codex without leaking private project content.
Privacy model
The game rewards work shape, not work contents.
Allowed game data
- Abstract event type, category, score, checksum, and sequence
- Aggregated totals such as Chonks, Space Bucks, suit condition, and event counts
- Inventory, orders, upgrades, base modules, asteroid class, and claim progress
- Portal account settings, referral code state, and revocable device records
Excluded private data
- Prompts, assistant replies, transcripts, source code, and diffs
- File paths, repo names, command output, terminal output, and browser contents
- OpenAI credentials, passwords, API keys, raw tokens, or personal documents
- Anything not needed to compute or display game progress
Referral crew
Invite other miners into your crew.
Your referral code and invite link live on the Profile page. When another player signs up or redeems your code, the Referral Crew area shows your crew count and the public space charter names that joined through you. Referral rewards are currently recorded as account events; future settings can use those records for configurable Space Bucks sharing.
Common commands
Useful things to ask Codex.
Status
@mcp-miner status@mcp-miner show asteroid status@mcp-miner show inventory and orders
Progress
@mcp-miner refine useful materials@mcp-miner fulfill ready orders@mcp-miner buy the best affordable upgrades
Sync
@mcp-miner start account link@mcp-miner complete account link@mcp-miner sync cloud