$PAPERMCPan MCP server for Papertrade
How long does
1000x live?
An MCP server that lets any AI agent open a Papertrade position at up to 1000x and watch the liquidation line. Here it trades a simulated $10 on the real BTC price.
connecting BTC price: Hyperliquid public feed connecting
Simulated position
Receipts 0Longest 00:00.00 PAPER (simulated)
Simulated position$10 margin, BTC
- Entry
- waiting
- Liquidation
- waiting
- Room left
- waiting
- PnL
- waiting
agentauto: fades the move
- waiting for the first BTC price
The position is simulated: no wallet, no order, nothing sent anywhere. The price is real. The agent fades the move: it opens on the side the price is heading toward, so its line sits in the path, and flips if the price runs away from it. Touch Long, Short or the slider to take over. Liquidation for leverage L: long at entry × (1 - 1/L) / (1 - m), short at entry × (1 + 1/L) / (1 + m), with m = 0.05% maintenance margin. No fees or funding.
01 · you
Tell it the size and the leverage.
02 · papermcp
It opens the trade and watches the line.
03 · the line
You get rekt, or you get paper.
tools/list
What it does
Six tools. Your agent picks one from what you say, and the price feed runs live on this page.
| # | Tool | What it does | Status |
|---|---|---|---|
| 01 | get_price | The live BTC price. The simulator above reads it from the Hyperliquid public feed, several times a second. | Live |
| 02 | watch_liquidation | Watches a position against the price and says how much room is left before the line. | Rolling out |
| 03 | open_position | Opens a long or a short at the leverage you set, after you see the liquidation price in the chat. | Rolling out |
| 04 | close_position | Closes some or all of a position before the line closes it for you. | Rolling out |
| 05 | get_pool | The protocol pool on the other side of every trade: how big it is and what it owes. | Rolling out |
| 06 | get_paper_balance | How much PAPER you have been minted for getting liquidated. | Rolling out |
6 tools1 livethank you for your patience
mcp.json
Connect
One block in your MCP client's config. Paste it, restart, ask.
- 01Starts read only. Opening positions is a switch you turn on.
- 02Every open shows the liquidation price in the chat first. No yes, no trade.
- 03A leverage cap and a daily loss cap you set, enforced by the server, not the agent.
{
"mcpServers": {
"papertrade": {
"command": "npx",
"args": ["-y", "papermcp"],
"env": {
"PAPERMCP_MODE": "read-only",
"PAPERMCP_MAX_LEVERAGE": "50",
"PAPERMCP_DAILY_LOSS_CAP_USD": "20"
}
}
}
}