Skip to main content
AllMCPs
BrowseBestCategoriesStackCompareToolsGuidesBlog
Log in Submit MCP

Stay in the loop

Get new MCP servers and top picks in your inbox.

AllMCPs

The open directory for discovering and installing Model Context Protocol servers.

AllMCPs on GitHub (opens in a new tab)
Launched onTiny Startupstinystartups.com
Explore
  • Browse servers
  • Best MCP servers
  • Categories
  • MCP clients
  • Agent prompts
  • Stack Builder
  • Compare servers
  • Random discovery New
  • Submit a server
  • Pricing & Boost Boost
Learn
  • Guides hub
  • What is MCP?
  • Install guide
  • Build an MCP server
  • Deploy an MCP server
  • Security guide
  • Troubleshooting
  • MCP for SEO & AEO
  • Protocol versioning
  • Blog & updates
Tools
  • All developer tools
  • Config generator
  • Config validator
  • Config auditor
  • MCP playground
  • Token calculator
  • OpenAPI โ†’ MCP
  • Badge generator
For agents
  • REST API docs
  • Trust & traffic Live
  • Remote MCP server SSE โ†— (opens in a new tab)
  • llms.txt โ†— (opens in a new tab)
  • Catalog JSON โ†— (opens in a new tab)
Company
  • About
  • Advertise Sponsor
  • Contact
  • GitHub โ†— (opens in a new tab)
  • Terms
  • Privacy
AllMCPs VerifiedAllMCPs VerifiedFeatured on Nick LaunchesFeatured on Nick LaunchesLaunch Llama NewsletterLaunch Llama NewsletterVerified DR - allmcps.comVerified DR - allmcps.comFeatured on SaaSGrowFeatured on SaaSGrowFeatured on Twelve ToolsFeatured on Twelve ToolsFeatured on Saaspa.geFeatured on Saaspa.geFeatured on Findly.toolsFeatured on Findly.toolsFeatured on Startup FameFeatured on Startup FameFeatured on LaunchKiwiFeatured on LaunchKiwiFeatured on ScrollLaunchFeatured on ScrollLaunchFeatured on DailyPingsFeatured on DailyPingsFazier badgeFazier badgeFeatured on NewTool.siteFeatured on NewTool.siteFeatured on saasfame.comFeatured on saasfame.comDR Checker - Domain RatingDR Checker - Domain RatingListed on Turbo0Listed on Turbo0Launched on LaunchBoard - Product Launch PlatformLaunched on LaunchBoard - Product Launch PlatformList on SimilarlabsList on Similarlabshttps://codetrendy.comhttps://codetrendy.comListed on DevTool.ioFeatured on BuildlistFeatured on BuildlistLaunched on Tiny StartupsFeatured on ShowMeBestAIFeatured on ShowMeBestAIFind us on LaunchZoneFind us on LaunchZoneAllMCPs VerifiedAllMCPs VerifiedFeatured on Nick LaunchesFeatured on Nick LaunchesLaunch Llama NewsletterLaunch Llama NewsletterVerified DR - allmcps.comVerified DR - allmcps.comFeatured on SaaSGrowFeatured on SaaSGrowFeatured on Twelve ToolsFeatured on Twelve ToolsFeatured on Saaspa.geFeatured on Saaspa.geFeatured on Findly.toolsFeatured on Findly.toolsFeatured on Startup FameFeatured on Startup FameFeatured on LaunchKiwiFeatured on LaunchKiwiFeatured on ScrollLaunchFeatured on ScrollLaunchFeatured on DailyPingsFeatured on DailyPingsFazier badgeFazier badgeFeatured on NewTool.siteFeatured on NewTool.siteFeatured on saasfame.comFeatured on saasfame.comDR Checker - Domain RatingDR Checker - Domain RatingListed on Turbo0Listed on Turbo0Launched on LaunchBoard - Product Launch PlatformLaunched on LaunchBoard - Product Launch PlatformList on SimilarlabsList on Similarlabshttps://codetrendy.comhttps://codetrendy.comListed on DevTool.ioFeatured on BuildlistFeatured on BuildlistLaunched on Tiny StartupsFeatured on ShowMeBestAIFeatured on ShowMeBestAIFind us on LaunchZoneFind us on LaunchZone
ยฉ 2026 Jackalope Digital LLC. All rights reserved.
  1. Home
  2. ๐Ÿ’ฐ Finance & Fintech
  3. Perp Cli
Perp Cli logo
Health: ActiveRecent health check succeeded.Last checked 9/9/2026, 7:31:48 PM

Perp Cli

User RatingsBe the first to rate and review this MCP server!
View Repository35 GitHub StarsTotal stargazers on GitHub for the source repository (35 stars).Visit Website
perpetual-futuresdextradingarbitrageportfolio

CLI MCP server for multi-DEX perpetual futures trading across Solana, HyperEVM, Ethereum, and BNB Chain.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent โ€” or use 1-click editor setup below.

Add to CursorAdd to VS Code
Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag โ€” we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON โ–พ

Client Config & Setup

Choose your client or environment
Target File:~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hypurrquant-perp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "perp-cli"
      ]
    }
  }
}

๐Ÿ’ก Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Install Directory Badge Claim listing Alternatives๐Ÿ’ฐ More in Finance & Fintech

Overview

This MCP server provides command-line tools for trading perpetual futures on four decentralized exchanges: Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), and Aster (BNB Chain). It supports market data retrieval, trade execution with safety checks, funding rate arbitrage scanning, portfolio analytics, and cross-exchange fund management including bridging. Use it to automate, monitor, and analyze multi-chain perpetual futures trading strategies with bot support and background job management.

Use cases

โ€ขRetrieve market data and orderbook details across multiple DEXes
โ€ขExecute and manage perpetual futures trades with dry-run validation
โ€ขScan and execute funding rate arbitrage opportunities
โ€ขAnalyze cross-exchange portfolio balances, positions, and risk
โ€ขManage funds including deposits, withdrawals, transfers, and cross-chain bridging

Key features

โ€ขSupports 4 DEXes: Pacifica, Hyperliquid, Lighter, Aster
โ€ขFunding rate arbitrage scanning and dual-leg execution
โ€ขUnified portfolio overview with balances, positions, and risk
โ€ขMulti-provider cross-chain bridging and inter-exchange rebalancing
โ€ข19 trading bot algorithms with background job supervision
โ€ขAgent-first CLI design with JSON output and pre-trade safety checks

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Perp Cli.

Extracted Tool Capabilities
Supports 4 DEXes: Pacifica, Hyperliquid, Lighter, Aster
Funding rate arbitrage scanning and dual-leg execution
Unified portfolio overview with balances, positions, and risk
Multi-provider cross-chain bridging and inter-exchange rebalancing
19 trading bot algorithms with background job supervision
Agent-first CLI design with JSON output and pre-trade safety checks

Documentation Overview

perp-cli

npm version npm downloads license

Multi-DEX perpetual futures CLI โ€” Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), Aster (BNB Chain).

Terminal
npm install -g perp-cli       # global install
perp --json portfolio

# Or without global install (restricted environments)
npx -y perp-cli --json portfolio

Features

  • 4 Exchanges โ€” trade, bridge, arbitrage across Pacifica, Hyperliquid, Lighter, Aster
  • Funding Rate Arb โ€” perp-perp + spot-perp scan & one-command dual-leg execution
  • Portfolio โ€” single call returns balances, positions, risk level across all exchanges
  • Funds โ€” deposit, withdraw, transfer, multi-provider bridge (cctp/relay/debridge), inter-exchange rebalance โ€” all in one group
  • Bots โ€” TWAP, grid, DCA, trailing-stop with background job management
  • Agent-First Design โ€” --json, --fields, --ndjson, --dry-run, runtime schema introspection
  • Safety โ€” pre-trade validation, response sanitization, client-id deduplication

Setup

bash
# Set exchange keys
perp wallet set pac <SOLANA_KEY>     # Pacifica
perp wallet set hl <EVM_KEY>         # Hyperliquid
perp wallet set lt <EVM_KEY>         # Lighter (API key auto-generated)
perp wallet set aster <API_KEY>      # Aster (BNB Chain)

# Or interactive setup wizard
perp setup

# Verify
perp wallet show

Same EVM key works for both Hyperliquid and Lighter.

Lighter API Key Index: Indexes 0โ€“3 are reserved by Lighter's frontend (web/mobile). perp-cli defaults to index 4. Override with LIGHTER_API_KEY_INDEX env var, or use perp wallet agent approve lighter --api-key-index <n> for managed agent slots. Valid range: 4โ€“254.

Command Groups

GroupDescription
marketPrices, orderbook, funding, klines, HIP-3 dexes
accountBalance, positions, orders, margin
tradeMarket/limit/stop orders, close, scale, split execution
outcomeHyperliquid Outcome (HIP-4) โ€” binary/range contracts, USDH-quoted, no leverage
arbFunding rate arb โ€” scan, exec, close, monitor (perp-perp & spot-perp)
strategy19 bot algorithms (grid, dca, twap, APEX, REFLECT, presets) + nested scripted plans
fundsDeposit, withdraw, transfer, cross-chain bridge (multi-provider), inter-exchange rebalance
riskRisk limits, liquidation distance, guardrails
walletMulti-wallet management, agent wallets (wallet agent ...), margin mode / subaccount / API keys (wallet manage ...), on-chain balances
historyExecution log, PnL, performance breakdown
portfolioCross-exchange unified overview (replaces former account balance / status / dashboard)
healthAdapter health check across all 4 DEX
settingsCLI settings (referrals, defaults, fees)
backtestStrategy backtesting
backgroundBackground process supervisor (tmux sessions for strategies, alerts, etc.)
alertsFunding rate alerts (Telegram / Discord) with background daemon
setupInteractive setup wizard (alias: init)

Core Commands

bash
# Portfolio (balances + positions + risk across all exchanges)
perp --json portfolio

# Market data
perp --json -e <EX> market list
perp --json -e <EX> market book <SYM>
perp --json -e <EX> market mid <SYM>              # fast mid-price lookup
perp --json -e <EX> market funding <SYM>
perp --json -e <EX> market kline <SYM> 1h          # candlestick data
perp --json -e hl market hip3                       # list HIP-3 deployed dexes

# Trading
perp --json -e <EX> trade buy <SYM> <SIZE>          # shortcut for market buy
perp --json -e <EX> trade sell <SYM> <SIZE>         # shortcut for market sell
perp --json -e <EX> trade market <SYM> buy <SIZE> --smart  # IOC limit (less slippage)
perp --json -e <EX> trade split <SYM> buy 5000      # orderbook-aware split (large orders)
perp --json -e <EX> trade close <SYM>
perp --json -e <EX> trade flatten                    # close ALL positions on exchange
perp --json -e <EX> trade reduce <SYM> 50            # reduce position by 50%
perp --json -e <EX> trade cancel <SYM>               # cancel by symbol (or orderId)
perp --json -e <EX> trade tpsl <SYM> long            # set take-profit / stop-loss
perp --json -e <EX> trade leverage <SYM> <N>

# Account
perp --json -e <EX> account balance
perp --json -e <EX> account positions
perp --json -e <EX> account pnl                      # realized + unrealized + funding
perp --json -e <EX> account funding                  # personal funding payment history
perp --json -e <EX> account settings                 # per-market leverage & margin mode

# Outcome markets (Hyperliquid HIP-4 โ€” fully-collateralized binary contracts, USDH-quoted, $10 min)
perp --json outcome list                                       # active markets + Yes/No mid prices
perp --json outcome view <outcome>                             # symmetric Yes/No book + underlying gap + expiry
perp --json outcome book <outcome> <side>                      # one-side orderbook (e.g. '1 yes' or '1 0')
perp --json outcome positions                                  # open outcome holdings
perp --json outcome orders                                     # open outcome orders
perp --json outcome buy <outcome> <side> <usd> --dry-run       # validate before submit
perp --json outcome buy <outcome> <side> <usd>                 # market buy in USDH notional
perp --json outcome sell <outcome> <side> <usd> --limit <px> --tif gtc
perp --json outcome cancel <outcome> <side> <oid>

# Funding rate arbitrage
perp --json arb scan --min 5                         # perp-perp opportunities
perp --json arb scan --mode spot-perp                # spot+perp opportunities
perp --json arb scan --rates                         # funding rates across all exchanges
perp --json arb scan --basis                         # cross-exchange basis opportunities
perp --json arb scan --gaps                          # cross-exchange price gaps
perp --json arb scan --hip3                          # HIP-3 cross-dex funding spreads
perp --json arb scan --live                          # continuous live monitoring
perp --json arb exec <SYM> <longEx> <shortEx> <$>   # perp-perp dual-leg entry
perp --json arb exec <SYM> spot:<exch> <perpEx> <$>  # spot+perp entry
perp --json arb config                               # show arb defaults
perp --json arb history                              # past arb trade performance (alias: log)

# Funds (deposit, withdraw, transfer, bridge, rebalance)
perp --json funds deposit hyperliquid 100
perp --json funds withdraw pacifica 50
perp --json funds transfer 100 <ADDRESS>             # HL internal transfer (instant)
perp --json funds bridge quote --from solana --to arbitrum --amount 100
perp --json funds bridge send --from solana --to arbitrum --amount 100   # auto-cheapest provider
perp --json funds bridge exchange --from pacifica --to hyperliquid --amount 100
perp --json funds rebalance check                    # balances across exchanges
perp --json funds rebalance plan                     # compute optimal moves
perp --json funds rebalance execute --auto-bridge    # withdraw โ†’ bridge โ†’ deposit
perp --json funds info                               # all routes & limits

# Risk
perp --json risk limits --max-leverage 5
perp --json risk liquidation-distance

# Strategies (19 bot algorithms + nested scripted plans)
perp strategy list-strategies                        # list all available strategies
perp strategy run <strategy> [symbol]                # run any strategy
perp strategy apex [symbol]                          # APEX autonomous orchestrator
perp strategy reflect                                # trading performance analysis
perp strategy preset-list                            # list strategy presets
perp --json strategy twap <SYM> buy <SIZE> 30m
perp --json strategy grid <SYM> --range 5 --grids 10 --size 100
perp strategy plan example                           # scripted multi-step plan format
perp --json strategy plan validate <FILE>            # validate scripted plan
perp --json strategy plan execute <FILE> --dry-run   # dry-run scripted plan

# Background process supervisor (tmux)
perp background list                                 # list running jobs
perp background stop <ID>                            # stop a job
perp background logs <ID> -f                         # follow logs

Telegram Alerts

Funding rate alerts via Telegram with background daemon support.

bash
# Interactive setup (BotFather token + chat ID auto-detection)
perp alerts setup

# Add alert rules
perp alerts add ETH 30              # alert when ETH funding > 30% annualized
perp alerts add --all 50            # alert for any symbol > 50%

# Test & manage
perp alerts test                    # send test message
perp alerts list                    # show active rules

# Run daemon
perp alerts start                   # foreground
perp alerts start --background      # tmux background daemon
perp alerts stop                    # stop background daemon

Setup flow: BotFather token โ†’ bot validation โ†’ send /start to bot โ†’ auto-detect chat ID โ†’ test message.

Exchange flag: -e hyperliquid / -e pacifica / -e lighter / -e aster (aliases: hl, pac, lt).

Global flags: --json, --fields <f>, --ndjson, --dry-run, --dex <name> (HIP-3), -w, --wallet <name>.

MCP Server

Glama MCP server

perp-cli includes a full-featured MCP server (18 tools, 3 resources, 2 prompts) for Claude Desktop, Cursor, and other MCP clients.

Read the full README โ†’View source on GitHub โ†’

Related MCP Servers

View all in Finance & Fintech View all alternatives
  • Tasty Agent logoTasty Agent

    Tastyworks API integration to handle trading activities on Tastytrade

    ๐Ÿ’ฐ Finance & Fintech4 views
    Compare vs Tasty Agent โ†’
  • Lighter MCP logoLighter MCP

    MCP server for Lighter โ€” a zero-fee zk-rollup perpetual DEX. Trade 190 perpetuals (crypto + RWA: PAXG/XAU gold, XAG silver, WTI oil, equity tickers like TSLA/AMZN/ASML) from Claude Desktop, Cursor, Hermes, or any MCP client. Three credential tiers (PUBLIC market data โ†’ READ account โ†’ TRADE signing), native on-chain stop-loss / take-profit, server-side safety caps (max-quote-USD, slippage, symbol allowlist). pip install 0xdegenmo-lighter-mcp.

    ๐Ÿ’ฐ Finance & Fintech4 views
    Compare vs Lighter MCP โ†’
  • MCP Server Ccxt logoMCP Server Ccxt

    An MCP server for accessing real-time crypto market data and trading via 20+ exchanges using the CCXT library. Supports spot, futures, OHLCV, balances, orders, and more.

    ๐Ÿ’ฐ Finance & Fintech4 views
    Compare vs MCP Server Ccxt โ†’
  • Tradingview MCP logoTradingview MCP

    Real-time market data, screeners, technical analysis & backtesting for stocks, crypto and forex.

    ๐Ÿ’ฐ Finance & Fintech4 views
    Compare vs Tradingview MCP โ†’

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks โ€” not a rating.

GitHub stars
35
Stargazers on the source repository.
npm downloads
238
Package downloads in the last 30 days.
Last commit
8d ago
Most recent push to the default branch.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet โ€” be the first to share how this listing worked for you.

Frequently Asked Questions about Perp Cli

It supports Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), and Aster (BNB Chain).

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPerp Cli AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hypurrquant-perp-cli?style=directory)](https://allmcps.com/mcp/hypurrquant-perp-cli)
HTML Embed
<a href="https://allmcps.com/mcp/hypurrquant-perp-cli"><img src="https://allmcps.com/api/badge/hypurrquant-perp-cli?style=directory" alt="Perp Cli on AllMCPs" /></a>

Technical Specs & Signals

Category๐Ÿ’ฐFinance & Fintech
PricingFree
More technical detailsExpand โ–พ
TransportSTDIO
RuntimeNode.js
AuthAPI key
LicenseMIT
Last updatedSep 4, 2026
10/10 checks healthy over the last 31d
Views2
Unique ViewsTotal visits recorded for this listing page on AllMCPs.
Installs0
Installs & Copy ActionsTotal times users copied install commands or configuration snippets for this server.
GitHub stars35
GitHub Star CountTotal stargazers on GitHub representing community popularity (35 stars).
Last commit8d ago
Last Repository CommitThe most recent commit or push recorded for this server's GitHub repository.Last commit on Sep 4, 2026
npm downloads238/mo
Monthly npm DownloadsAverage monthly package installs recorded from npm registry statistics.
57Quality signal: Good ยท 57/100How this signal is calculated โ–พ
Server availabilityNot measured

Not scored for repo-hosted servers โ€” we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20
Documentation & tools24/30
Adoption & activity9/15
Community engagement0/10

A guidance signal from public completeness & health data โ€” not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 23d ago via OSV.dev ยท perp-cli (npm)

โ˜… Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge โ€” proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it โ€” no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ๐Ÿ’ฐ Finance & Fintech โ†’Best MCP servers for Finance & Fintech โ†’Alternatives to Perp Cli โ†’Install in Claude DesktopInstall in CursorInstall in VS Code