Pacifica MCP Skill#

When to Use#

Trigger when the user:

• Asks about crypto prices, perps, or trading on Pacifica / Solana
• Wants to check their trading account, positions, or open orders
• Wants to place, modify, or cancel trades
• Wants market data (orderbooks, candles, funding rates, recent trades)
• Mentions BTC, ETH, SOL, or any perpetual contract on Pacifica
• Wants real-time price/trade monitoring via WebSocket

When NOT to Use#

• General knowledge ("What is a perpetual contract?")
• Math or computation ("What's 10x leverage on $1000?")
• Questions answerable from training data alone

Tool Selection#

User IntentToolKey ParamsPrice of Xpacifica-pricessymbolMy account/balancepacifica-account—My positionspacifica-positions—Open a long / buypacifica-market-ordersymbol, side: "bid", amountOpen a short / sellpacifica-market-ordersymbol, side: "ask", amountLimit orderpacifica-limit-ordersymbol, side, amount, price, tifStop orderpacifica-stop-ordersymbol, side, stop_price, amountSet TP / SLpacifica-set-tpslsymbol, side (exit side!), take_profit_price, stop_loss_priceCancel orderpacifica-cancel-ordersymbol, order_id (omit to cancel all)Cancel stop orderpacifica-cancel-stopsymbol, order_idEdit orderpacifica-edit-ordersymbol, order_id, price, amountBatch orderspacifica-batch-orderactions (array, max 10)Orderbookpacifica-orderbooksymbolCandles / chartpacifica-candlessymbol, interval, limitMark price candlespacifica-mark-candlessymbol, interval, limitFunding ratespacifica-funding-ratessymbol, limitRecent tradespacifica-recent-tradessymbolAvailable marketspacifica-markets—Order historypacifica-order-historylimitTrade history / PnLpacifica-trade-historysymbol, limitEquity curvepacifica-portfoliotime_rangeDeposits / withdrawalspacifica-balance-historylimitOrder details by IDpacifica-order-by-idorder_idAccount settingspacifica-account-settings—My open orderspacifica-orders—Set leveragepacifica-set-leveragesymbol, leverageCross / isolated marginpacifica-set-margin-modesymbol, is_isolatedWallet addresspacifica-wallet—Create subaccountpacifica-create-subaccount—List subaccountspacifica-list-subaccounts—Transfer USDC to subaccountpacifica-transfer-fundsto_account, amountWithdraw USDCpacifica-withdrawamountAll available toolspacifica-tools—Watch trades livepacifica-watchchannel, symbol, durationMonitor real-timepacifica-watch-start → pacifica-watch-read → pacifica-watch-stopchannel, symbol

Parameter Guide#

• symbol: Perps use uppercase with no suffix — BTC, ETH, SOL, DOGE. Spot markets use SOL-USDC, BTC-USDC, ETH-USDC. Run pacifica-markets to discover all symbols.
• side: "bid" = long/buy, "ask" = short/sell
• amount: Always a decimal string ( "0.1", "1.5"). Min order value is $10.
• price: Always a decimal string ( "70000", "3500")
• tif: GTC (default), IOC (immediate-or-cancel), ALO (post-only), TOB (top-of-book)
• interval: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d

Critical Behaviors#

• set-tpsl side is the EXIT side, not the position side. Long position → side: "ask". Short position → side: "bid".
• null responses mean success for: set-leverage, set-margin-mode, set-tpsl. Verify changes with pacifica-account-settings or pacifica-positions.
• Deposits happen on the Pacifica web app ( test-app.pacifica.fi testnet, pacifica.fi mainnet). Not through MCP or CLI.
• Wallet auto-generated on first run at ~/.pacifica-mcp/config.json. Users import the private key into Phantom/Backpack to deposit.
• Order confirmation: For interactive use, briefly confirm order details with the user before placing. For autonomous/bot use, execute directly.
• Withdrawals are USDC only. If user has SOL or other spot assets and wants to withdraw, they must sell on the spot market first (e.g. pacifica-market-order symbol: "SOL-USDC" side: "ask") to convert to USDC, then withdraw.
• Subaccount funding: Deposit to main account first via web app, then use pacifica-transfer-funds to move USDC to the subaccount. Min transfer: $10.
• Spot markets (SOL-USDC, BTC-USDC, ETH-USDC): Same order tools work. Use the spot symbol format. Max leverage is 1x (no leverage on spot).

WebSocket (Real-Time)#

ModeToolsUse CaseSnapshotpacifica-watchQuick check: collect events for N seconds (max 60)Persistentwatch-start → watch-read → watch-stopOngoing monitoring

Channels: prices, trades, orderbook, account_info, account_positions, account_trades

• trades and orderbook require a symbol parameter.
• prices streams ALL markets — use summary_only: true on watch-read to avoid data flooding.
• watch-read supports max_events (default 100) and summary_only (default false).

Free vs Wallet-Required#

Free: markets, prices, orderbook, candles, mark-candles, recent-trades, funding-rates, account, positions, orders, order-history, trade-history, portfolio, balance-history, order-by-id, account-settings, wallet, tools, watch, watch-start, watch-read, watch-stop

Wallet (signed): market-order, limit-order, stop-order, set-tpsl, cancel-order, cancel-stop, edit-order, batch-order, set-leverage, set-margin-mode, create-subaccount, list-subaccounts, transfer-funds, withdraw

Error Handling#

ErrorCauseFix404 accountNot deposited yetDirect to test-app.pacifica.fi or pacifica.fi422 amount too lowOrder < $10 minimumIncrease amount429 rate limitedToo many requestsBack off, retryVerification failedBad signatureCheck wallet with pacifica-wallet

Example Workflows#

Open a leveraged long#

text

1. pacifica-prices (symbol: "BTC") → check mark price
2. pacifica-set-leverage (symbol: "BTC", leverage: 10)
3. pacifica-market-order (symbol: "BTC", side: "bid", amount: "0.01")
4. pacifica-positions → confirm position opened

Risk management#

text

1. pacifica-positions → note position side
2. pacifica-set-tpsl (symbol: "BTC", side: "ask", take_profit_price: "100000", stop_loss_price: "60000")
   (side is "ask" because exiting a long)

Monitor and react#

text

1. pacifica-watch-start (channel: "trades", symbol: "BTC")
2. pacifica-watch-read (subscription_id: "...", summary_only: true) → check activity
3. pacifica-watch-stop → cleanup

CLI Alternative#

The same 36 tools are available as a standalone CLI for terminal use:

bash

npm install -g @pacifica-dev/cli

pacifica prices --symbol BTC
pacifica positions
pacifica market-order --symbol SOL --side bid --amount 0.5
pacifica wallet
pacifica watch --channel trades --symbol ETH --duration 10

Output is JSON. Pipe to jq for filtering: pacifica prices --symbol BTC | jq '.mark'

Install#

bash

# MCP server (Claude Code, Cursor, Windsurf, VS Code Copilot, etc.)
claude mcp add pacifica npx @pacifica-dev/mcp

# Standalone CLI
npm install -g @pacifica-dev/cli