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 Intent	Tool	Key Params
Price of X	pacifica-prices	symbol
My account/balance	pacifica-account	—
My positions	pacifica-positions	—
Open a long / buy	pacifica-market-order	symbol, side: "bid", amount
Open a short / sell	pacifica-market-order	symbol, side: "ask", amount
Limit order	pacifica-limit-order	symbol, side, amount, price, tif
Stop order	pacifica-stop-order	symbol, side, stop_price, amount
Set TP / SL	pacifica-set-tpsl	symbol, side (exit side!), take_profit_price, stop_loss_price
Cancel order	pacifica-cancel-order	symbol, order_id (omit to cancel all)
Cancel stop order	pacifica-cancel-stop	symbol, order_id
Edit order	pacifica-edit-order	symbol, order_id, price, amount
Batch orders	pacifica-batch-order	actions (array, max 10)
Orderbook	pacifica-orderbook	symbol
Candles / chart	pacifica-candles	symbol, interval, limit
Mark price candles	pacifica-mark-candles	symbol, interval, limit
Funding rates	pacifica-funding-rates	symbol, limit
Recent trades	pacifica-recent-trades	symbol
Available markets	pacifica-markets	—
Order history	pacifica-order-history	limit
Trade history / PnL	pacifica-trade-history	symbol, limit
Equity curve	pacifica-portfolio	time_range
Deposits / withdrawals	pacifica-balance-history	limit
Order details by ID	pacifica-order-by-id	order_id
Account settings	pacifica-account-settings	—
My open orders	pacifica-orders	—
Set leverage	pacifica-set-leverage	symbol, leverage
Cross / isolated margin	pacifica-set-margin-mode	symbol, is_isolated
Wallet address	pacifica-wallet	—
Create subaccount	pacifica-create-subaccount	—
List subaccounts	pacifica-list-subaccounts	—
Transfer USDC to subaccount	pacifica-transfer-funds	to_account, amount
Withdraw USDC	pacifica-withdraw	amount
All available tools	pacifica-tools	—
Watch trades live	pacifica-watch	channel, symbol, duration
Monitor real-time	pacifica-watch-start → pacifica-watch-read → pacifica-watch-stop	channel, 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)

Mode	Tools	Use Case
Snapshot	pacifica-watch	Quick check: collect events for N seconds (max 60)
Persistent	watch-start → watch-read → watch-stop	Ongoing 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

Error	Cause	Fix
404 account	Not deposited yet	Direct to test-app.pacifica.fi or pacifica.fi
422 amount too low	Order < $10 minimum	Increase amount
429 rate limited	Too many requests	Back off, retry
Verification failed	Bad signature	Check wallet with pacifica-wallet

Example Workflows

Open a leveraged long

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

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

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:

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

# 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