Documentation / Grok
Connect an assistant
One hosted URL for Grok, Claude, ChatGPT, and other MCP clients. 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
- 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
Grok
Grok iOS
In the Grok app: Connectors → Custom. URL https://app.tapehall.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 Tapehall in the xAI catalog from here.
Grok Build / grok CLI — in a terminal:
Or add this to ~/.grok/config.toml:
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.
IDE / desktop MCP clients
- Open your client's MCP / Tools settings.
- Add this server. Replace the key. Save, then refresh until it shows connected.
For OAuth sign-in instead of an API key, omit the header and add "auth": {"CLIENT_ID": "tapehall"}. An API key in X-Api-Key still works.
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 Tapehall account. Claude Code uses the same sign-in.
- Grok — grok.com/connectors → New Connector → Custom. Same server URL. Client id
tapehall. Leave the secret empty. Token auth method: none. - ChatGPT — Plugins, then Add custom MCP server. Server URL
https://app.tapehall.com/mcp. Authentication: OAuth. Leave the registration method on the one ChatGPT discovers. Sign in with your Tapehall 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
tapehall-chatgpt. Leave the client secret empty. Token endpoint auth method: none.
Order book, prints, and candles
market_bookis 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_book_ordersis stored resting orders for one coin, at most one day: order id, wallet, side, limit price, size, notional, and status. Same read asGET /v1/market/book_orders.market_book_changesis adds and size updates at or above 50,000 USD, at most one day. Time is the line's place in the hourly file, not the exchange clock. Removes usually have no size, so they are not listed here.market_book_flowis one row per minute and side, at most 7 days: notional added, notional on remove lines, and counts of new, update, and remove. Remove lines usually have no size, so the removed notional is often zero.market_tapeis the recent prints: time, price, size, side, and age (age_sin seconds,ageas text), newest first.nexus_get_barsis the candles. The last bar is the newest.desk_bookis open positions, each with how long it has been open (age_s,age,opened_at).exec_positions,desk_bookandmarket_tapetake an optionalage_format: seconds (default), minutes, hms, or auto. If the opening time cannot be proven the age is null, never a guess.scanner_print_seqis sequence statistics, not the print list.
Paste into Grok (system / instructions)
Pause in Strategies is the kill switch. Closing the chat does not cancel working orders. YAML recipes: Strategies.