Log inSubmit server
Perp Cli logo

Perp Cli

by hypurrquant

Trade and analyze perpetual futures across multiple DEX venues with market data, portfolio, funding, and execution tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Perp Cli

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hypurrquant-perp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The hypurrquant/perp-cli MCP server connects AI agents to multi-DEX perpetual futures markets across venues including Pacifica, Hyperliquid, Lighter, Aster, and others. Its 18 tools cover market data, portfolio analytics, funding-rate arbitrage, cross-exchange comparisons, and trade execution with dry-run support. It also exposes fund movement and background strategy capabilities such as TWAP, grid, DCA, and trailing stops. Reach for it when an agent needs to inspect or operate perpetual futures accounts across supported venues from one interface.

Use cases

  • Compare perpetual markets across supported exchanges
  • Scan funding-rate arbitrage opportunities
  • Analyze balances, positions, and portfolio risk
  • Simulate or execute supported perpetual trades
  • Run automated TWAP, grid, DCA, or trailing-stop jobs

Key features

  • Multi-venue perpetual market data
  • Dry-run trading with pre-trade validation
  • Funding-rate arbitrage scanning
  • Cross-exchange portfolio analytics
  • Structured JSON and NDJSON output
  • Background trading strategy jobs

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

17/17 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · perp-cli (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars40Stargazers on the source repository.
npm downloads942Package downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Perp Cli works

What hypurrquant/perp-cli does

The hypurrquant/perp-cli MCP server gives agents access to perpetual futures operations across multiple venues and chains. Supported trading venues include Pacifica on Solana, Hyperliquid on HyperEVM, Lighter on Ethereum, Aster on BNB Chain, Lighter RH on Robinhood chain, Ondo Perps, Arcus, and QFEX. Other venues provide market data only in the documented release, including RISEx, TxFlow, Variational, GRVT, and Extended. Derive contributes read-only options data.

This makes the project relevant to the Finance & Fintech category for agents that need a consolidated view of derivatives markets. The toolset covers market inspection, account state, funding conditions, execution, and comparisons between venues rather than focusing on a single exchange.

How it works

The CLI presents structured output for agent use. JSON output, field selection, newline-delimited JSON, dry-run execution, and runtime schema inspection are available for automation. A single portfolio request can combine balances, positions, and risk information across exchanges.

Trading support varies by venue. Some exchanges support public and user WebSocket streams, while others expose only request-based market data. Funding-rate scans distinguish verified funding data from display-only rates; unverified venues are not ranked or traded by funding strategies. The project also supports funding arbitrage scans covering perp-perp and spot-perp opportunities, with dual-leg execution where the venue capabilities allow it.

Setup and configuration

Install the CLI globally with npm or invoke it through npx. Wallet keys are imported into an encrypted OWS vault and are read from a hidden prompt or standard input rather than command-line arguments. One EVM key can serve Hyperliquid and Lighter. Lighter trading additionally requires agent approval, while Lighter RH, Ondo Perps, and Arcus use venue-specific agent or API-key registration.

The interactive setup wizard can select wallets, networks, venues, a default venue, and slippage settings. A non-interactive setup mode supports scripted configuration and can target testnet. The LIGHTER_API_KEY_INDEX setting changes Lighter's managed API-key slot; the documented default is index 4.

Tools and capabilities

The hypurrquant/perp-cli MCP server supports capabilities including:

  • Market data and cross-exchange comparisons
  • Perpetual trading with pre-trade validation and dry-run checks
  • Portfolio balances, positions, and risk information
  • Funding-rate arbitrage discovery and supported dual-leg execution
  • Deposits, withdrawals, transfers, bridging, and inter-exchange rebalancing where supported
  • TWAP, grid, DCA, and trailing-stop background jobs
  • Spot and options data on venues that expose those markets

Execution safety includes response sanitization and client-ID deduplication. Native TWAP is available on some venues, while others use client-side slicing. Venue-specific restrictions determine which operations are available.

Limitations and notes

Capabilities are not uniform across venues. Several integrations are read-only, market-data-only, or dependent on later releases for trading. QFEX has restrictions on resting reduce-only orders and automation. Some deposit and withdrawal actions remain web-app-only, and funding rates marked unverified are shown only when explicitly requested.

The support matrix describes implemented functionality, not proof that an operation has been completed with real funds. WebSocket book and trade channels are not available according to the documentation, and some user-channel or stream support has known gaps. Credentials and agent approvals must be configured separately for venues that do not support direct wallet import.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Perp Cli

hypurrquant/perp-cli is an MCP server that connects AI agents to perpetual futures venues including Pacifica, Hyperliquid, Lighter, Aster, and others. Its main tools provide market data, portfolio analytics, funding-rate arbitrage scanning, cross-exchange comparisons, and supported trade execution with dry-run safety.

Install it globally with `npm install -g perp-cli`, or run it without a global install using `npx -y perp-cli`. Wallet and venue setup are configured separately through the CLI's setup and wallet commands.

Configure wallets with the interactive `perp setup` wizard or import a venue key using `perp wallet set`. Keys are read through a hidden prompt or standard input and stored in an encrypted OWS vault. Some venues instead require agent or API-key approval.

It describes the project as a CLI and MCP server but does not provide client compatibility details for Cursor.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

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>