Advertise
MCP.so
Sign In
P

Perp Cli MCP Server

@hypurrquant

Repository

Basic information

Category

Developer Tools

Transports

stdio

Author

hypurrquant

Submitted by

Hui-Sang Kim

About Perp Cli MCP Server

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

Perp Cli MCP Server 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>"
      }
    }
  }
}

Perp Cli MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

Frequently asked questions

1

What exchanges does Perp Cli support?

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

2

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.

3

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.

4

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.

5

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.

Comments

More Developer Tools MCP servers

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

1

LocalCan

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

82

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

3

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

3
Advertise