Perp CLI

Name: Perp CLI
Author: hypurrquant

hypurrquant

CLI and MCP server for perpetual futures on Pacifica, Hyperliquid and Lighter: market data, trading with dry runs and funding rate scans.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add perp-cli --env HYPERLIQUID_PRIVATE_KEY='<HYPERLIQUID_PRIVATE_KEY>' --env PACIFICA_PRIVATE_KEY='<PACIFICA_PRIVATE_KEY>' -- npx -y -p perp-cli perp-mcp

~/.codex/config.toml

[mcp_servers.perp-cli]
command = "npx"
args = ["-y", "-p", "perp-cli", "perp-mcp"]
env = { HYPERLIQUID_PRIVATE_KEY = "<HYPERLIQUID_PRIVATE_KEY>", PACIFICA_PRIVATE_KEY = "<PACIFICA_PRIVATE_KEY>" }

# codex mcp add perp-cli --env HYPERLIQUID_PRIVATE_KEY='<HYPERLIQUID_PRIVATE_KEY>' --env PACIFICA_PRIVATE_KEY='<PACIFICA_PRIVATE_KEY>' -- npx -y -p perp-cli perp-mcp

~/.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "perp-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ],
      "env": {
        "HYPERLIQUID_PRIVATE_KEY": "<HYPERLIQUID_PRIVATE_KEY>",
        "PACIFICA_PRIVATE_KEY": "<PACIFICA_PRIVATE_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

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

claude_desktop_config.json

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

.trae/mcp.json

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

Environment variables

HYPERLIQUID_PRIVATE_KEY
PACIFICA_PRIVATE_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related