Perp Cli

Name: Perp Cli
Author: hypurrquant

@hypurrquant

About Perp Cli

MCP server for perpetual futures trading across Pacifica (Solana), Hyperliquid (HyperEVM), and Lighter (Ethereum). 18 tools for market data, portfolio management, trade execution with dry-run safety, funding rate arbitrage scanning, and analytics.

#trading #defi #perpetual-futures #arbitrage #finance #hyperliquid #solana #ethereum #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "perp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ],
      "env": {
        "HYPERLIQUID_PRIVATE_KEY": "<YOUR_EVM_KEY>",
        "PACIFICA_PRIVATE_KEY": "<YOUR_SOLANA_KEY>",
        "LIGHTER_PRIVATE_KEY": "<YOUR_EVM_KEY>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Perp Cli?

Perp Cli is a multi-DEX perpetual futures CLI for Pacifica (Solana), Hyperliquid (HyperEVM), and Lighter (Ethereum). It provides trading, arbitrage scanning, portfolio management, bots, and an MCP server for AI agent integration.

How to use Perp Cli?

Install globally with npm install -g perp-cli, set exchange keys using perp wallet set, then run commands such as perp --json portfolio. For MCP server use npx -y perp-cli perp-mcp in your MCP client config.

Key features of Perp Cli

Trade, bridge, and arbitrage across three DEXes
Funding rate arbitrage scan with one-command dual-leg execution
Unified portfolio view across all exchanges
Bots: TWAP, grid, DCA, trailing-stop with background job management
Agent‑first CLI with structured JSON output and runtime schema introspection
Pre‑trade validation, response sanitization, and client‑id deduplication
MCP server with 18 tools – market data without API keys

Use cases of Perp Cli

Scan and execute funding rate arbitrage opportunities across exchanges
Manage cross‑exchange portfolio and risk exposure from one CLI
Deploy automated trading bots (TWAP, grid, DCA) with background daemons
Integrate perpetual futures commands into AI agents via MCP protocol
Bridge USDC across chains and manage deposits/withdrawals

FAQ from Perp Cli

What exchanges does Perp Cli support?

Pacifica (Solana), Hyperliquid (HyperEVM), and Lighter (Ethereum).

Do I need API keys to use Perp Cli?

No API keys are required for market data commands. Keys are only needed to trade or access account data.

How do I set up Perp Cli for trading?

Run perp wallet set hl <EVM_KEY> for Hyperliquid, perp wallet set pac <SOLANA_KEY> for Pacifica, and perp wallet set lt <EVM_KEY> for Lighter. The same EVM key works for Hyperliquid and Lighter.

What is the MCP server included with Perp Cli?

It's a full MCP server (18 tools, 3 resources, 2 prompts) that allows Claude Desktop, Cursor, and other MCP clients to run Perp Cli commands. Read‑only tools require no keys.

How can I get structured JSON output from Perp Cli?

Use the --json flag on any command to get a JSON envelope with ok, data, and meta fields. Use --fields to filter specific fields and --ndjson for streaming lists.