typus-perp-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NETWORK | No | The Sui network (e.g., MAINNET, TESTNET) | MAINNET |
| PRIVATE_KEY | No | Your Sui wallet private key (optional for read-only tools, required for trading/liquidity tools) | |
| SUI_RPC_URL | No | The Sui RPC URL | https://fullnode.mainnet.sui.io:443 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_marketsA | Get all active trading markets and their configurations on Typus Perp (leverage, fees, funding rates, etc.) |
| get_lp_poolsA | Get TLP liquidity pool information including TVL and per-token liquidity amounts |
| get_stake_poolsB | Get TLP staking pool information including current TLP price and total staked shares |
| get_positionsA | Get all open positions for a wallet address, including liquidation price, unrealized PnL, funding fee, borrow fee, and close fee for each position |
| get_ordersA | Get all pending (unfilled) trading orders for a specific wallet address |
| get_user_stakeA | Get a user's TLP staking positions including staked share amounts, claimable rewards, and any shares currently in the unstaking cooldown period |
| create_orderA | Create a trading order on Typus Perp. Requires PRIVATE_KEY in .env. Size and collateral amounts are raw integers — use get_markets to find size_decimal for the trading token. |
| cancel_orderB | Cancel a pending trading order. Requires PRIVATE_KEY in .env. |
| increase_collateralA | Add more collateral to an existing position to reduce liquidation risk. Requires PRIVATE_KEY in .env. |
| release_collateralB | Withdraw excess collateral from an existing position. Requires PRIVATE_KEY in .env. |
| collect_funding_feeB | Collect accumulated funding fees for a position. Requires PRIVATE_KEY in .env. |
| mint_stake_lpB | Deposit tokens into the TLP liquidity pool and optionally stake the resulting TLP. Requires PRIVATE_KEY in .env. |
| stake_lpA | Stake existing TLP tokens in the stake pool to earn rewards. Requires PRIVATE_KEY in .env. |
| unstakeA | Begin unstaking TLP (starts the unlock countdown). Requires PRIVATE_KEY in .env. |
| unstake_redeemA | Unstake and immediately redeem TLP for underlying tokens in one transaction. ⚠️ This does NOT return tokens to your wallet directly — you must call claim() afterwards to receive the underlying collateral. Requires PRIVATE_KEY in .env. |
| redeem_tlpA | Redeem TLP tokens (already unstaked) for underlying assets. ⚠️ This does NOT return tokens to your wallet directly — you must call claim() afterwards to receive the underlying collateral. Full flow: unstake → redeem_tlp → claim. Requires PRIVATE_KEY in .env. |
| claimA | Claim redeemed TLP tokens back as underlying collateral. This is the final step after unstake → redeem → claim. Requires PRIVATE_KEY in .env. |
| harvest_rewardA | Harvest pending staking reward tokens (e.g. TYPUS tokens). Requires PRIVATE_KEY in .env. |
| swapB | Swap tokens using Typus Perp liquidity pool. Requires PRIVATE_KEY in .env. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Each tool targets a distinct resource and action: user staking vs pool info, order creation vs cancellation, collateral management, and the multi-step unstake/redeem/claim flow are all clearly separated. Even similar-sounding tools like unstake and unstake_redeem have explicit descriptions that delineate their purposes.
Most tools follow a verb_noun snake_case pattern (get_markets, create_order, increase_collateral), but a few are bare verbs (unstake, claim, swap) or compound verbs (mint_stake_lp, unstake_redeem). This is a minor deviation from the otherwise consistent convention.
With 19 tools, the set is slightly heavy but each tool earns its place given the dual domains of perpetuals trading and TLP staking/LP management. The count is justifiable for the breadth of operations covered.
Core workflows are well-covered: order lifecycle, position collateral management, staking/unstaking/redeeming/claiming, and swaps. Minor gaps exist, such as no explicit wallet balance tool to check free TLP or token holdings, but these can be worked around via user-supplied information or external chain queries.