perp-cli 0.6.0 → 0.6.2

package/README.md

@@ -158,6 +158,43 @@ Exchange flag: `-e hyperliquid` / `-e pacifica` / `-e lighter` (aliases: `hl`, `
 
 Global flags: `--json`, `--fields <f>`, `--ndjson`, `--dry-run`, `--dex <name>` (HIP-3), `-w, --wallet <name>`.
 
+## MCP Server
+
+[![Glama MCP server](https://glama.ai/mcp/servers/hypurrquant/perp-cli/badges/score.svg)](https://glama.ai/mcp/servers/hypurrquant/perp-cli)
+
+perp-cli includes a full-featured MCP server (18 tools, 3 resources, 2 prompts) for Claude Desktop, Cursor, and other MCP clients.
+
+**No API keys required for market data** — explore prices, orderbooks, funding rates, and arb opportunities without any setup. Add keys only when you want to trade.
+
+```json
+{
+  "mcpServers": {
+    "perp-cli": {
+      "command": "npx",
+      "args": ["-y", "-p", "perp-cli", "perp-mcp"]
+    }
+  }
+}
+```
+
+Optional: add keys for trading and account data:
+```json
+{
+  "env": {
+    "HYPERLIQUID_PRIVATE_KEY": "your-evm-key",
+    "PACIFICA_PRIVATE_KEY": "your-solana-key"
+  }
+}
+```
+
+**Read-only tools (no keys):** `get_markets`, `get_orderbook`, `get_funding_rates`, `get_prices`, `arb_scan`, `health_check`
+
+**Account & trading tools (keys required):** `get_balance`, `get_positions`, `portfolio`, `trade_preview`, `trade_execute`, `trade_close`, `get_funding_analysis`, `get_pnl_analysis`, `get_arb_compare`
+
+**Resources:** `market://prices`, `market://funding-rates`, `perp://schema`
+
+**Prompts:** `trading-guide`, `arb-strategy`
+
 ## AI Agent Skill
 
 Install as a skill for Claude Code, Cursor, Codex, Gemini CLI, etc.:

package/dist/mcp-server.js

@@ -51,6 +51,71 @@ async function getOrCreateAdapter(exchange) {
     adapters.set(key, adapter);
     return adapter;
 }
+/** Try to get adapter, returns null if no key configured (for read-only fallback) */
+async function tryGetAdapter(exchange) {
+    const key = exchange.toLowerCase();
+    if (adapters.has(key))
+        return adapters.get(key);
+    try {
+        return await getOrCreateAdapter(exchange);
+    }
+    catch {
+        return null;
+    }
+}
+/** Fetch markets using public API (no key needed) */
+async function fetchMarketsPublic(exchange) {
+    const ex = exchange.toLowerCase();
+    if (ex === "pacifica" || ex === "pac") {
+        const data = await fetchPacificaPrices();
+        return data.map(d => ({ symbol: d.symbol, markPrice: String(d.mark), indexPrice: String(d.mark), fundingRate: String(d.funding), volume24h: "0", openInterest: "0", maxLeverage: 10 }));
+    }
+    else if (ex === "hyperliquid" || ex === "hl") {
+        const data = await fetchHyperliquidMeta();
+        return data.map(d => ({ symbol: d.symbol, markPrice: String(d.markPx), indexPrice: String(d.markPx), fundingRate: String(d.funding), volume24h: "0", openInterest: "0", maxLeverage: 50 }));
+    }
+    else if (ex === "lighter" || ex === "lt") {
+        const data = await fetchLighterOrderBookDetails();
+        return data.map(d => ({ symbol: d.symbol, markPrice: String(d.lastTradePrice), indexPrice: String(d.lastTradePrice), fundingRate: "0", volume24h: "0", openInterest: "0", maxLeverage: 20 }));
+    }
+    throw new Error(`Unknown exchange: ${exchange}. Supported: pacifica, hyperliquid, lighter`);
+}
+/** Fetch orderbook using public API (no key needed) */
+async function fetchOrderbookPublic(exchange, symbol) {
+    const ex = exchange.toLowerCase();
+    if (ex === "hyperliquid" || ex === "hl") {
+        const { HYPERLIQUID_API_URL } = await import("./api/public/urls.js");
+        const res = await fetch(HYPERLIQUID_API_URL, {
+            method: "POST", headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ type: "l2Book", coin: symbol.toUpperCase() }),
+        });
+        const data = await res.json();
+        return {
+            bids: (data.levels?.[0] ?? []).map(l => [l.px, l.sz]),
+            asks: (data.levels?.[1] ?? []).map(l => [l.px, l.sz]),
+        };
+    }
+    else if (ex === "lighter" || ex === "lt") {
+        const { LIGHTER_API_URL } = await import("./api/public/urls.js");
+        const res = await fetch(`${LIGHTER_API_URL}/api/v1/orderBookOrders?market_id=0&limit=20`);
+        const data = await res.json();
+        return {
+            bids: (data.bids ?? []).map(l => [l.price, l.remaining_base_amount ?? l.size ?? "0"]),
+            asks: (data.asks ?? []).map(l => [l.price, l.remaining_base_amount ?? l.size ?? "0"]),
+        };
+    }
+    else if (ex === "pacifica" || ex === "pac") {
+        const { PACIFICA_API_URL } = await import("./api/public/urls.js");
+        const baseUrl = PACIFICA_API_URL.replace("/info/prices", "");
+        const res = await fetch(`${baseUrl}/info/l2Book?symbol=${symbol.toUpperCase()}`);
+        const data = await res.json();
+        return {
+            bids: (data.l?.[0] ?? []).map(e => [e.p, e.a]),
+            asks: (data.l?.[1] ?? []).map(e => [e.p, e.a]),
+        };
+    }
+    throw new Error(`Unknown exchange: ${exchange}`);
+}
 // ── JSON envelope helpers ──
 function ok(data, meta) {
     return JSON.stringify({ ok: true, data, meta }, null, 2);
@@ -65,24 +130,34 @@ const server = new McpServer({ name: "perp-cli", version: _pkg.version }, { capa
 // ============================================================
 // Market Data tools (read-only, no private key needed)
 // ============================================================
-server.tool("get_markets", "Get all available perpetual futures markets on an exchange, including price, funding rate, volume, and max leverage", { exchange: z.string().describe("Exchange name: pacifica, hyperliquid, or lighter") }, async ({ exchange }) => {
+server.tool("get_markets", "Get all available perpetual futures markets on an exchange, including price, funding rate, volume, and max leverage. Works without API keys.", { exchange: z.string().describe("Exchange name: pacifica, hyperliquid, or lighter") }, async ({ exchange }) => {
     try {
-        const adapter = await getOrCreateAdapter(exchange);
-        const markets = await adapter.getMarkets();
-        return { content: [{ type: "text", text: ok(markets, { exchange, count: markets.length }) }] };
+        // Try adapter first (richer data), fall back to public API (no key needed)
+        const adapter = await tryGetAdapter(exchange);
+        if (adapter) {
+            const markets = await adapter.getMarkets();
+            return { content: [{ type: "text", text: ok(markets, { exchange, count: markets.length }) }] };
+        }
+        const markets = await fetchMarketsPublic(exchange);
+        return { content: [{ type: "text", text: ok(markets, { exchange, count: markets.length, source: "public" }) }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: err(e instanceof Error ? e.message : String(e), { exchange }) }], isError: true };
     }
 });
-server.tool("get_orderbook", "Get the order book (bids and asks) for a symbol on an exchange", {
+server.tool("get_orderbook", "Get the order book (bids and asks) for a symbol on an exchange. Works without API keys.", {
     exchange: z.string().describe("Exchange name: pacifica, hyperliquid, or lighter"),
     symbol: z.string().describe("Trading pair symbol, e.g. BTC, ETH, SOL"),
 }, async ({ exchange, symbol }) => {
     try {
-        const adapter = await getOrCreateAdapter(exchange);
-        const book = await adapter.getOrderbook(symbol);
-        return { content: [{ type: "text", text: ok(book, { exchange, symbol }) }] };
+        // Try adapter first (richer data), fall back to public API (no key needed)
+        const adapter = await tryGetAdapter(exchange);
+        if (adapter) {
+            const book = await adapter.getOrderbook(symbol);
+            return { content: [{ type: "text", text: ok(book, { exchange, symbol }) }] };
+        }
+        const book = await fetchOrderbookPublic(exchange, symbol);
+        return { content: [{ type: "text", text: ok(book, { exchange, symbol, source: "public" }) }] };
     }
     catch (e) {
         return { content: [{ type: "text", text: err(e instanceof Error ? e.message : String(e), { exchange, symbol }) }], isError: true };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perp-cli",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter",
   "bin": {
     "perp": "dist/index.js",
@@ -15,7 +15,7 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "test": "vitest run --exclude '**/integration/**'",
-    "test:integration": "vitest run '**/*.integration.test.ts'",
+    "test:integration": "vitest run -c vitest.integration.config.ts",
     "test:all": "vitest run",
     "prepublishOnly": "pnpm run build"
   },
@@ -29,11 +29,18 @@
     "cli",
     "trading",
     "funding-rate",
-    "arbitrage"
+    "arbitrage",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agent",
+    "perpetual-futures",
+    "defi",
+    "ethereum"
   ],
   "license": "MIT",
   "engines": {
-    "node": "^20.0.0 || ^22.0.0"
+    "node": "^20.0.0 || ^22.0.0 || ^24.0.0"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",

package/skills/perp-cli/SKILL.md

@@ -5,12 +5,29 @@ allowed-tools: "Bash(perp:*), Bash(npx perp-cli:*), Bash(npx -y perp-cli:*)"
 license: MIT
 metadata:
   author: hypurrquant
-  version: "0.5.1"
+  version: "0.6.1"
 ---
 
 # perp-cli Agent Guide
 
-Multi-DEX perpetual futures CLI — Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum).
+Multi-DEX perpetual futures CLI + MCP server — Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum).
+
+[![Glama MCP server](https://glama.ai/mcp/servers/hypurrquant/perp-cli/badges/score.svg)](https://glama.ai/mcp/servers/hypurrquant/perp-cli)
+
+## MCP Server
+
+18 tools, 3 resources, 2 prompts. No API keys required for market data — explore prices, orderbooks, funding rates, and arb opportunities without setup.
+
+```json
+{
+  "mcpServers": {
+    "perp-cli": {
+      "command": "npx",
+      "args": ["-y", "-p", "perp-cli", "perp-mcp"]
+    }
+  }
+}
+```
 
 ## Rules
 
@@ -24,7 +41,7 @@ Multi-DEX perpetual futures CLI — Pacifica (Solana), Hyperliquid (HyperEVM), L
 ## Install
 
 ```bash
-perp --version 2>/dev/null  # check if exists (must be >= 0.5.1)
+perp --version 2>/dev/null  # check if exists (must be >= 0.6.1)
 npm install -g perp-cli@latest 2>/dev/null || npx -y perp-cli@latest --json --version
 ```