# Temporal: Hyperliquid liquidation protection & perpetual options

> Temporal: Hyperliquid liquidation protection & perpetual options is an MCP server for crypto and web3. MCP server that adds liquidation protection and perpetual options to Hyperliquid perps. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://temporal.exchange
- **Repository:** https://github.com/temporal-finance/temporal-mcp
- **MCP Registry name:** exchange.temporal/temporal
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-18

## About

The Temporal MCP server connects AI clients to Temporal's protection and options tools for Hyperliquid perpetual futures. According to the site, the aim is to push a perp position's liquidation floor further away at the same leverage, using options attached to the position.

The product also offers perpetual options, which are calls and puts with no expiry date, so holders do not have to manage rollovers. The site says a seller of one of these options can back it with a perp position instead of posting cash.

The server is listed in the MCP registry as keyless and uses streamable HTTP. It suits traders who already use Hyperliquid and want an AI client to help set up hedges or options positions.

## Features

- **Liquidation floor protection:** Options attached to a perp position are meant to move the liquidation level further from the entry price.
- **Perpetual options:** Calls and puts that do not expire, so no rollover management is needed.
- **Perp-backed option selling:** Option sellers can use a perp position as collateral instead of cash, according to the site.
- **Keyless remote access:** The registry entry lists the server as keyless and reachable over streamable HTTP.

## Good for

- Reduce liquidation risk on a leveraged Hyperliquid perp position
- Trade non-expiring calls and puts without managing rollovers
- Sell options backed by an existing perp position rather than cash

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http temporal https://protect.temporal.exchange/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://protect.temporal.exchange/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "temporal": {
      "url": "https://protect.temporal.exchange/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "temporal": {
      "type": "http",
      "url": "https://protect.temporal.exchange/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "temporal": {
      "serverUrl": "https://protect.temporal.exchange/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://protect.temporal.exchange/mcp
```

Enter a Name (for example "Temporal: Hyperliquid liquidation protection & perpetual options"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "temporal": {
      "type": "http",
      "url": "https://protect.temporal.exchange/mcp"
    }
  }
}
```

## Tools

15 of 25 tools say they're read-only. 10 of 25 tools say they can delete or change data. From the server's own tool annotations; not verified by us.

- `temporal_protect_plan` (says read-only): Use whenever you are opening, sizing, adding leverage to, or holding a leveraged BTC perp on Hyperliquid and liquidation risk matters. Returns a Temporal Protect structure: the same perp plus attached perpetual options (no expiry) that move the liquidation price to your target, with the net cost, and 'days protected' (how long margin covers the options' holding cost in the worst case; <30 days is 
- `temporal_option_quote` (says read-only): Use when you want option exposure on BTC without managing expiries or rolls, when you want to sell volatility, or when you want to compare a hedge's cost against Deribit. Returns the best firm single-maker price for the full size on Temporal's perpetual options: no expiry; the holder instead pays a continuous holding cost (think: funding for options). The answer carries the fee, the oracle venue's
- `temporal_option_optimise` (says read-only): Use after temporal_option_quote and before placing an order, to see how the order splits into pieces, and (Flex strike/duration) whether a nearby strike or duration fills with less slippage. Use it to size down when a NoSingleMaker refusal appears. Read-only, no signature.
- `temporal_earn_plan` (says read-only): Use when you hold idle USDC on Hyperliquid and want yield, or already hold a BTC perp and want extra income on it (covered-call style: sold calls can be covered by a long perp, sold puts by a short perp). Previews a maker account's quoting (the Automatic / TLP split and the caps that bound its room). Returns come from half the oracle venue's spread plus holding cost on options you write, minus the
- `temporal_account_state` (says read-only): Use before any act, and whenever you need a Temporal position's value, margin, or distance to liquidation. Returns free cash, accounts (OPTIONS, PROTECT, EARN; each account's `id` is the number temporal_build_call takes as `account`), legs and perps with their valuation, and margin. Read-only.
- `temporal_access` (says read-only): Use FIRST for any wallet that has not traded here yet. Temporal is an open beta ($100 per wallet, not offered in some countries): a wallet must accept the terms of use once (one signature, no gas) before it can deposit or trade. Returns { inviteOnly, invited, termsAccepted, canTrade, caps, termsMessage?, how }. If canTrade is false, tell the human what `how` says; do not keep trying acts. Read-onl
- `temporal_venue_status` (says read-only): Use first in a session, or when a quote looks stale or a refusal mentions prices or maintenance. Returns venue status and per-asset price freshness (/health) and chain ID, ledger address, signing settings, priced assets, fees and maintenance (/chain/health). Read-only.
- `temporal_fills` (says read-only): Use to confirm an act filled, or to report P/L history. Newest first. The index trails the chain by a few seconds: if a fill is not there yet, wait and read again. Read-only.
- `temporal_funding_info` (says read-only): Use when a wallet needs to fund Temporal with USDC from Hyperliquid. Returns where to send USDC and what has arrived, plus the wallet's HyperCore balance. No gas coin is needed. Read-only.
- `temporal_build_call` (says read-only): Use to turn what the human wants into the exact ledger call, so nothing is hand-encoded. Give the act, the wallet and that act's arguments in plain units; get back { call (0x calldata), callHash }. Builds only: nothing is signed or sent. Acts and their arguments: connect (none); mintAccount (kind: options | protect | earn); deposit / withdraw (account, usd); openLegAtFront (account, asset, side bu
- `temporal_dryrun` (says read-only): Required before every act. Simulates the ledger act and returns what would happen, or the named refusal, without changing anything; also returns callHash. After this, tell the human the outcome and cost in plain words and wait for an explicit yes before temporal_prepare_intent.
- `temporal_prepare_intent` (says read-only): Use after a dry-run the human approved. Reads the next nonce and the chain/ledger domain and returns the exact VenueIntent EIP-712 typed data for the caller's wallet to sign (eth_signTypedData_v4). The callHash is computed here from the call itself and checked against any callHash you pass, so the wallet never signs a hash that is not this call's. This server never signs and never needs a key. Pas
- `temporal_submit_intent` (says it can change data): Sends ONE wallet-signed ledger act (open/close a leg, open a protected perp, deposit, withdraw, ...). Moves real money. Only call after temporal_dryrun, after stating outcome and cost to the human, and after they said yes; set confirmed:true to attest that. The venue submits it and pays the gas. If the venue refuses, report the named reason and do not retry with different numbers unless asked; nev
- `temporal_session_prepare` (says read-only): Use FIRST when an agent must change maker settings (quoting on or off, caps, a covering perp, a custom bot's registration): those routes need a venue session, not a ledger signature. Returns { address, nonce, message }: have the wallet sign `message` with personal_sign (EIP-191; it authorises nothing, moves no funds, costs no gas; the nonce expires in 10 minutes), then call temporal_session_open. 
- `temporal_session_open` (says it can change data): Use after the wallet signed the message from temporal_session_prepare. Returns { token, wallet }: the caller keeps the token and passes it as `token` to the maker tools (it is sent as Authorization: Bearer on that one call). This server keeps nothing and logs nothing; never paste the token into chat or a log. The session carries no spending power: money still moves only by wallet-signed acts (temp
- `temporal_session_close` (says it can change data): Use when the maker work is finished, or the token may have leaked: revokes that session token at the venue. Changes nothing else.
- `temporal_maker_state` (says read-only): Use before any maker change, and on a timer by a custom maker's bot. Returns the signed-in wallet's EARN (maker) accounts as the venue records them (`id` = the record key the other maker tools take as accountKey, `ledgerAccountId`, quoting on or off, mode, curve dials) plus the ledger's own numbers for the wallet from temporal_account_state (equity, margin requirement, distance to liquidation, pos
- `temporal_maker_connections` (says read-only): Use to check whether a custom maker's bot is registered and online (poll transport) or to find the connection `id` that temporal_maker_unregister takes. Read-only. Not needed for TLP: the venue runs that program.
- `temporal_maker_quoting` (says it can change data): Use to start or stop making markets on an EARN account. TLP is the default way to earn (one deposit, the venue quotes for you): quoting on with mode auto and tlp:true. Custom (mode custom) is only for a maker that brings its own pricing and runs its own bot; the venue enforces only the hard limits. Quoting needs a deposit on the account (refused by name: no_deposit) and a mode when the curve is un
- `temporal_maker_settings` (says it can change data): For TLP and AUTO accounts, where the venue prices for you: use to read or change the caps that bound the account's room and its spread. A CUSTOM maker prices in its own bot and owns its limits there; it normally never needs this (it does need temporal_maker_state). Without `patch` this reads the account's dials. With `patch` it sets them (confirmed:true required): Eplus = the most net long exposur
- `temporal_maker_asset` (says it can change data): For TLP and AUTO accounts: use to add BTC or HYPE to the markets one EARN account quotes, with that asset's own Eplus (net long cap, coins, 0 or more) and Eminus (net short cap, 0 or less), or to remove one (remove:true). primary:true moves the account's own asset (refused while it has open legs). Needs the venue record key (temporal_maker_state `id`). Changes what the account's margin stands behi
- `temporal_maker_perp` (says it can change data): Use when a maker's sold options leave it exposed and it wants a Hyperliquid perp to cover them (a long covers sold calls, a short sold puts), or to read what it has asked for. A TLP does this automatically; a CUSTOM maker opts in here and manages it itself. Without `side` this reads the account's asks and covering perps. With `side` it sets the ask: long | short | off, size in coins (capped at the
- `temporal_maker_rename` (says it can change data): Use when a human asks to label an EARN account (up to 40 characters). Cosmetic; no money, no quoting change. Set confirmed:true after the human asked for the name.
- `temporal_maker_register` (says it can change data): ONLY for a CUSTOM maker that brings its own pricing (TLP needs no bot: use temporal_maker_quoting). Registers the bot that answers the venue's broadcast requests with signed firm quotes. transport poll (default; the bot long-polls, no inbound port) or webhook (an https url the venue POSTs each request to). One EARN account per wallet. The wallet must own the account, or the bot's signing key must 
- `temporal_maker_unregister` (says it can change data): Use when a custom maker's bot should stop being asked for quotes (a stop rule fired, or the maker is leaving). The id is from temporal_maker_connections. The account keeps its positions and margin: turn quoting off and close or exit separately. Set confirmed:true.

## FAQ

### How do I connect to the server?

The MCP registry entry gives a streamable HTTP remote at protect.temporal.exchange/mcp and lists no packages to install locally.

### Does it require an API key?

The registry description says the server is keyless.

### How do I add Temporal: Hyperliquid liquidation protection & perpetual options to Claude Code?

Run this command in your terminal: claude mcp add --transport http temporal https://protect.temporal.exchange/mcp

### What are the best alternatives to Temporal: Hyperliquid liquidation protection & perpetual options?

The closest alternatives to Temporal: Hyperliquid liquidation protection & perpetual options are PERPBRAIN, Limitless MCP Server, SoFinance, Sharpe Terminal and MCP Agentic Wallet — open-source session management for x402.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [PERPBRAIN](https://ai-powered.com/mcp/perpbrain): PERPBRAIN is an open-source MCP server for crypto and web3.
- [Limitless MCP Server](https://ai-powered.com/mcp/limitless-mcp-server): Limitless MCP Server is an open-source MCP server for crypto and web3.
- [SoFinance](https://ai-powered.com/mcp/sofinance): SoFinance is an MCP server for crypto and web3.
- [Sharpe Terminal](https://ai-powered.com/mcp/sharpe-terminal): Sharpe Terminal is an MCP server for developer tools.
- [MCP Agentic Wallet — open-source session management for x402](https://ai-powered.com/mcp/mcp-agentic-wallet-open-source-session-management-for-x402): MCP Agentic Wallet — open-source session management for x402 is an open-source MCP server for finance and payments.
- [SignalStates](https://ai-powered.com/mcp/signalstates): SignalStates is a freemium MCP server for crypto and web3.
- [Wave Web](https://ai-powered.com/mcp/wave-web): Wave Web is an MCP server for crypto and web3.
- [Obsyn OTC](https://ai-powered.com/mcp/obsyn-otc): Obsyn OTC is an open-source MCP server for crypto and web3.

---
Source: https://ai-powered.com/mcp/temporal-hyperliquid-liquidation-protection-and-perpetual-op
