Mirage docs

Mirage checks a Robinhood Chain token and your own buy rules, then drafts the trade for your wallet to sign. It holds no keys and never sends a transaction. Use it from the terminal or from any MCP client.

01Quick start

Needs Node.js 20 or newer.

$ npm install -g mirageagent
$ mirage check 0x…            # read a token from the chain
$ mirage buy 0x… 0.05 --why "dev bag burned, exit at 2x"

No install: npx -y mirageagent check 0x…

02Commands

Command	What it does
`mirage check <token>`	Check a token from the chain.
`mirage buy <token> <eth> --why "..."`	Your rules first, then an unsigned draft.
`--to 0x...`	Wallet that receives the tokens (or set it once with `mirage wallet`).
`--sign`	Open a local page that hands the draft to your browser wallet.
`--override "..."`	Go past a HOLD. The reason goes in your journal.
`mirage rules`	List your rules.
`mirage rules set <id> key=value`	For example `mirage rules set no_chase rise=2.5 minutes=15`.
`mirage rules on\|off <id>`	Turn a rule on or off.
`mirage journal [n]`	Your last checks, holds, drafts and overrides.
`mirage journal loss <token> [note]`	Log a losing exit (starts your cool down).
`mirage wallet <0x...>`	Default wallet for drafts.
`mirage mcp`	Run as an MCP server over stdio.
`--json`	Machine-readable output on any command.

03MCP

Add Mirage to Claude Desktop, Claude Code, Cursor or any MCP client:

{
  "mcpServers": {
    "mirage": { "command": "npx", "args": ["-y", "mirageagent", "mcp"] }
  }
}

Tool	What it does
`check_token`	Reads a token from the chain: launch, taxes, deployer, holders, dev bag, price and momentum.
`fomo_check`	Runs an intended buy through your rules. HOLD with the rules it breaks, or CLEAR with an unsigned draft. Never sends.
`get_rules`	Your rules and whether each is on.
`set_rule`	Turns a rule on or off or changes its numbers, only on your explicit request.
`journal`	Lists your recent checks, holds, drafts and overrides, or logs a losing exit.

04Token check

Every number is read from Robinhood Chain when you ask, with the explorer link next to it.

Line	What it reads
launch	Pons curve or pool, ETH on the curve, age.
taxes	Creator tax, curve fee, live snipe tax.
deployer	Past Pons launches and how many reached the DEX.
holders	Top 10 wallets, the largest one, the deployer's share. The Uniswap v4 pool is shown apart, not counted as a holder.
dev bag	Still held, sold, or burned to the dead address.
price	Curve or pool price, and the move inside your `no_chase` window.

Anything that crosses a red line is flagged. A red flag holds every buy while the red_flags rule is on.

05Rules

You write them on a calm day. Mirage holds you to them on a loud one. Rules only ever stop a buy; none of them tells you to buy.

Rule	Default	Settings
`no_chase`	No buy after a 3x in 10 minutes	`rise`, `minutes`
`max_size`	At most 0.05 ETH per trade	`eth`
`cool_down`	30 minutes after a losing exit	`minutes`
`why`	Write one line on why, before any buy	on or off
`red_flags`	No buy while the token check shows a red flag	on or off

$ mirage buy 0x… 0.2
  HOLD  max_size   At most 0.05 ETH
  HOLD  why        No reason written.

  HOLD  your own rules say wait.

$ mirage buy 0x… 0.05 --why "..."
  pass  max_size   At most 0.05 ETH
  pass  why        You wrote: "..."

  CLEAR  draft ready · Pons curve

One broken rule means HOLD: nothing is drafted. --override "reason" goes past it, and the reason lands in your journal.

06Drafts and signing

When every rule passes, Mirage writes an unsigned transaction: on the Pons curve before graduation, on the Uniswap v4 pool after. It shows the spend, the minimum out (5% slippage) and the receiving wallet.

--sign opens a page on your own machine that hands the draft to your browser wallet. You read it there and sign it, or you walk away. --json gives the raw transaction instead.

Mirage never asks for a private key and never broadcasts anything itself.

07Journal and data

Every check, hold, draft, override and logged loss goes in your journal. A logged loss starts the cool_down rule.

Rules, your default wallet and the journal stay on your machine in ~/.mirage. Nothing is uploaded.

08$MIRAGE

$MIRAGE is live on Robinhood Chain. The contract address shows at the top of miragerh.com once it is published, with a copy button.

Every burn is read from the chain and listed on the home page: each transfer of $MIRAGE to the dead or zero address since launch, with the amount, its share of supply and the transaction.