How to add perp-cli to Claude Desktop

Multi-DEX perpetual futures MCP server for Pacifica, Hyperliquid, Lighter & Aster — market data, trading, and funding-rate arbitrage. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 31★ · stdio · apikey

Claude Desktop config for perp-cli

npm install -g perp-cli

{
  "mcpServers": {
    "perp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ],
      "env": {
        "PACIFICA_PRIVATE_KEY": "your-solana-key",
        "HYPERLIQUID_PRIVATE_KEY": "your-evm-key",
        "LIGHTER_PRIVATE_KEY": "your-evm-key",
        "ASTER_API_KEY": "your-api-key"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the perp-cli config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm perp-cli's tools appear under the 🔌 tools menu.

Before you start

Node.js with npx (or a global `npm install -g perp-cli`)
For trading/account tools: exchange private keys or API keys (Pacifica Solana key, Hyperliquid/Lighter EVM key, Aster API key) supplied as environment variables
No credentials needed for market-data tools

What perp-cli can do in Claude Desktop

get_markets

List available markets across exchanges (read-only, no keys required).

get_orderbook

Fetch the orderbook for a symbol (read-only, no keys required).

get_funding_rates

Get current funding rates across exchanges (read-only, no keys required).

get_prices

Get current prices / mid prices (read-only, no keys required).

arb_scan

Scan for funding-rate arbitrage opportunities (read-only, no keys required).

health_check

Check adapter health across all four DEX (read-only, no keys required).

get_balance

Get account balance for an exchange (requires keys).

get_positions

List open positions (requires keys).

Security

Market-data tools require no credentials. Account and trading tools require exchange private keys / API keys supplied via environment variables (PACIFICA_PRIVATE_KEY, HYPERLIQUID_PRIVATE_KEY, LIGHTER_PRIVATE_KEY, ASTER_API_KEY). These keys control real funds on live DEX accounts — store them securely and be aware that trading tools can execute real orders. The same EVM key works for both Hyperliquid and Lighter. Responses are auto-sanitized (control chars stripped, prompt-injection patterns blocked).

perp-cli + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the perp-cli config there under the "mcpServers" key and restart the client.

Is perp-cli safe to use with Claude Desktop?

Do I need API keys to use the MCP server?

No — market-data tools (get_markets, get_orderbook, get_funding_rates, get_prices, arb_scan, health_check) work without any keys. Add exchange keys via environment variables only when you want account data and live trading.

How do I run the MCP server?

Add the mcpServers config block with command `npx` and args `["-y", "-p", "perp-cli", "perp-mcp"]` to your MCP client (Claude Desktop, Cursor, etc.). A global `npm install -g perp-cli` also works.

Which exchanges are supported?

Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), and Aster (BNB Chain). The same EVM key works for both Hyperliquid and Lighter.

View repo Full perp-cli page