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 tape, no Hyperliquid key in the assistant, live stays locked until you unlock it. You need a paid plan — a free account can create a key, but tools will say you still need a plan. Never put the key in the chat.

Do this, in order

Create an account. A passkey is optional — you can choose a plan and create a key first.
Choose a plan (Tier 1 or higher). This is what unlocks the assistant.
Open Portal → API keys. Click Create API key. Copy it once. Read is enough for paper.
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.
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

Open Settings → Tools & MCP (or edit ~/.cursor/mcp.json).
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 and ChatGPT

Claude — Settings → Connectors (or Claude Desktop MCP). Same URL and X-Api-Key header. Desktop can use the same JSON as Cursor.
ChatGPT — Custom GPT → Actions. Point at https://app.mrtrades.com/mcp (or POST /v1/mcp/call). Put the key in Action authentication, not the instructions.

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.
- You draft and validate strategies. Paper uses the full Hyperliquid tape MrTrades already stores — 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 stays locked until I unlock it. If a tool says live is locked, stop and tell me to unlock — 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. Call strategy_features before inventing predicate names. ATR is legal: atr / atr_14 (same Wilder 14 on the last closed 1m bar), atr_band_upper, atr_band_lower. Absorption is legal: absorption / absorption_bias (same 60s HyperTape viz metric). Cloud flags: press_upper, press_lower, above_cloud, below_cloud, in_cloud. A bare flag name means feat >= 1. Intro-even is trail.floor_ret_bps: 0 — there is no intro_even exit type.
3. Validate any YAML I give you (strategy_validate).
4. Paper it on the Hyperliquid tape (strategy_paper). Save the run.
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.