MrTrades

Documentation / Grok

Connect an assistant

One hosted URL for Grok, Cursor, Claude, and ChatGPT. Other Hyperliquid MCP servers exist — local wrappers of the public API, and some ask for a private key in the client. This one is a desk: paper on our stored history, no Hyperliquid key in the assistant, live trading stays off until you turn it on. You need a paid plan — a Starter account can create a key, but tools will say you still need a plan. Never put the key in the chat. If the assistant was connected before the order book was added, disconnect it and connect again so the tool list refreshes.

Do this, in order

  1. Create an account. A passkey is optional — you can choose a plan and create a key first.
  2. Choose a plan (Tier 1 or higher). This is what unlocks the assistant.
  3. Open Portal → API keys. Click Create API key. Copy it once. Read is enough for paper.
  4. Connect your assistant with the URL and header below. Ask it to build a Terminal desk or to validate and paper a strategy. After a desk change, open or refocus Terminal.
  5. Live later: Wallet → deposit USDC on Arbitrum → transfer to perps → unlock live in Account. Use a trade-scoped key only then.

The only URL you need

https://app.mrtrades.com/mcp Header: X-Api-Key: mtdp_YOUR_KEY

Grok

Grok iOS

In the Grok app: Connectors → Custom. URL https://app.mrtrades.com/mcp, header X-Api-Key. Put the key in the connector, never in a chat or a public share. If Safari bounces you, that is xAI’s Universal Link — paper also works in Portal → Strategies. We cannot list MrTrades in the xAI catalog from here.

Grok Build / grok CLI — in a terminal:

grok mcp add --transport http mrtrades https://app.mrtrades.com/mcp --header "X-Api-Key: mtdp_YOUR_KEY"

Or add this to ~/.grok/config.toml:

[mcp_servers.mrtrades] url = "https://app.mrtrades.com/mcp" headers = { "X-Api-Key" = "mtdp_YOUR_KEY" }

grok.com chat — if you see Tools or Actions, add a custom tool with the same URL. Put X-Api-Key in that tool’s settings, not in the message. Then paste the system prompt below into instructions.

Cursor

  1. Open Settings → Tools & MCP (or edit ~/.cursor/mcp.json).
  2. Add this server. Replace the key. Save, then refresh until it shows connected.
{ "mcpServers": { "mrtrades": { "url": "https://app.mrtrades.com/mcp", "headers": { "X-Api-Key": "mtdp_YOUR_KEY" } } } }

Claude, Grok, and ChatGPT

  • Claude — Settings → Connectors → Add custom connector. Same server URL. Leave the client id and secret empty, then sign in with your MrTrades account. Claude Code uses the same sign-in.
  • Grok — grok.com/connectors → New Connector → Custom. Same server URL. Client id mrtrades. Leave the secret empty. Token auth method: none.
  • Cursor sign-in — in the JSON above, omit the API key header and add "auth": {"CLIENT_ID": "mrtrades"}. Cursor can also register itself. An API key in X-Api-Key still works.
  • ChatGPT — Plugins, then Add custom MCP server. Server URL https://app.mrtrades.com/mcp. Authentication: OAuth. Leave the registration method on the one ChatGPT discovers. Sign in with your MrTrades account when asked. A paid plan is still required.
  • If that form does not fill in the OAuth addresses, choose User-Defined OAuth Client. Client id mrtrades-chatgpt. Leave the client secret empty. Token endpoint auth method: none.

Order book, prints, and candles

  • market_book is the live order book, also called the DOM. One snapshot of bids and asks for a coin such as PUMP or PUMP-USD. It is not a streaming socket, and it is not the account.
  • market_tape is the recent prints: time, price, size, side, and age (age_s in seconds, age as text), newest first.
  • nexus_get_bars is the candles. The last bar is the newest.
  • desk_book is open positions, each with how long it has been open (age_s, age, opened_at). exec_positions, desk_book and market_tape take an optional age_format: seconds (default), minutes, hms, or auto. If the opening time cannot be proven the age is null, never a guess. scanner_print_seq is sequence statistics, not the print list.

Paste into Grok (system / instructions)

You are helping me trade through MrTrades, not through Hyperliquid's own UI. Facts: - MrTrades is a desk in front of Hyperliquid. Perps settle on Hyperliquid. - Hosted tools: https://app.mrtrades.com/mcp - Auth belongs in the tool config as header X-Api-Key: mtdp_… — never in this chat and never in a public share. - Paper and reports work with a read key on a paid plan. LIVE needs a separate trade-scoped key and an unlocked account. - The live order book (DOM) is market_book: one current snapshot of bids and asks, not a streaming socket. Executed prints are market_tape, newest first. Candles are nexus_get_bars, newest bar last. desk_book is the account, not the book. - You draft and validate strategies. Paper uses the stored Hyperliquid history — not market_tape, and not a sample. The engine places orders. You do not send dust under Hyperliquid's $10 minimum. - Deposits, transfers, and withdrawals happen in the Wallet at https://app.mrtrades.com/wallet — you do not move funds. - Live trading is off until I turn it on. If a tool says live trading is off, stop and tell me to turn it on — do not invent a bypass. Do this, in order: 1. If I ask you to build or change my Terminal desk, call workspace_schema first, then workspace_set / workspace_add / workspace_remove / workspace_reset. To keep more than one layout, use workspace_save / workspace_list / workspace_open. To share, workspace_share and send me the link. Tell me to open or refocus Terminal. That is layout only — no orders. 2. Read https://mrtrades.com/llms-strategies.txt and call strategy_features before inventing predicate names. Print-seq: size_run_notional / size_run_count / size_run_side / size_run. Cloud: bare names are 1m; press_lower_15m and friends are that TF. Absorption has 15s / 60s / 5m plus bid_hold / ask_hold. Liquidity: resting_*, iceberg_*, bid_pull. Book feats replay in paper. trail.arm_on is a cloud/absorb flag. exit.opposing: false turns off the opposing-print clip. After unknown_feature, call product_request once on my behalf — do not invent the name and do not say it shipped. 3. Validate any YAML I give you (strategy_validate). 4. Paper it on the stored Hyperliquid history (strategy_paper). Save the run. That history is not market_tape. 5. Report fills, rejects, and why. Do not claim a live fill unless the engine said so. 6. If I ask to go live, remind me: Wallet funded, trading access approved, live unlocked, trade-scoped key in the tool config — then call the live tool only if those are true. If I ask you to "just send it on Hyperliquid" without MrTrades, refuse and point me at this path.

Pause in Strategies is the kill switch. Closing the chat does not cancel working orders. YAML recipes: Strategies.