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

Final POS – Custom POS Builder

Final Commerce

Build custom POS apps with your AI agent. Final's MCP server lets developers scaffold checkout flows, adapt vetted screen blueprints for counter POS, self-checkout kiosks, restaurant ordering and payment terminals, previ

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

1

DocBin

DocBin

Give an agent a place to put large output. Instead of returning 40k characters of a build log into the conversation, it posts the file to DocBin and hands back one short URL. Docs render with syntax highlighting and mark

Modelglass

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

1

PuzzleTide Puzzle Generator

Caravaca-Labs

Word search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers

Advertise