PacificaPATTERNS
/ MCP USAGE GUIDE

Talk to Pacifica through Claude

66 example prompts across 10 categories. Connect Claude to your Pacifica account via MCP, then just talk naturally.

/ Before you start — 3 steps

  1. 1.Go to test-app.pacifica.fi, connect your Solana wallet, enter access code Pacifica, and use the Faucet to get test USDC.
  2. 2.Clone the repo and run the init wizard — this auto-seeds 9 example patterns into ~/.pacifica/patterns/.
  3. 3.Configure your Claude client (see the Setup section below) and restart it. The hammer icon should show 23 Pacifica tools.
git clone https://github.com/Weminal-labs/pacifica_cli.git
cd pacifica_cli && pnpm install
npx tsx src/cli/index.ts init --testnet
/ SETUP

Connect Claude to Pacifica

  1. 1.
    Download and install Claude Desktopclaude.ai/download
  2. 2.
    Clone the Pacifica CLI repository
    git clone https://github.com/Weminal-labs/pacifica_cli.git && cd pacifica_cli && pnpm install
  3. 3.
    Initialize your Pacifica account (you need a wallet from test-app.pacifica.fi with test USDC from the Faucet). This command also auto-seeds example patterns into ~/.pacifica/patterns/.test-app.pacifica.fi
    npx tsx src/cli/index.ts init --testnet
  4. 4.
    Open the Claude Desktop config file. On macOS:
    open ~/Library/Application\ Support/Claude/claude_desktop_config.json
  5. 5.
    Add the Pacifica MCP server config (see below). Replace the path with your actual clone location.
  6. 6.
    Restart Claude Desktop (Cmd+Q, then reopen). Click the hammer icon — you should see 23 Pacifica tools.

Config to add

{
  "mcpServers": {
    "pacifica": {
      "command": "npx",
      "args": [
        "tsx",
        "/Users/YOUR_USERNAME/pacifica_cli/src/mcp/server.ts"
      ]
    }
  }
}
Note:Replace /Users/YOUR_USERNAME/pacifica_cli with the actual path where you cloned the repo. Run 'pwd' in terminal inside the project folder to get it.
23

MCP Tools Available

8 read + 2 analytics + 2 funding + 4 write + 7 pattern

/ Prompt status legend — click to filter

/ WHAT YOU CAN SAY

Example prompts by category

Markets & Prices

Real-time market data, prices, order books, and volume.

7
Show me all marketsREADY
What's the BTC price right now?READY
How's ETH doing?READY
Show me the SOL order bookREADY
What's the spread on BTC?READY
Which markets have the highest volume?READY
Find me markets with negative fundingREADY

Funding Rates

Funding rates, APR calculations, and historical data.

5
Show funding ratesREADY
Which coins pay you to hold long?READY
What's the funding APR on BTC?READY
Show me BTC funding historyREADY
Has ETH funding been negative this week?READY

Account & Positions

Balance, positions, P&L, orders, and trade history.

9
Show my account balanceACCOUNT
How much margin am I using?ACCOUNT
What are my positions?POSITIONS
Am I in profit?POSITIONS
Do I have any open orders?ACCOUNT
Show my overall P&L summaryACCOUNT
Show my win rate from Pacifica historyACCOUNT
Show my recent tradesACCOUNT
Show my ETH trade historyACCOUNT

Place Trades

Market orders, limit orders, leverage, and TP/SL. Uses real testnet USDC.

5
Buy 0.01 BTC with 3x leveragePLACES ORDER
Long 0.5 SOL with 3x leveragePLACES ORDER
Short 100 WIF at 5xPLACES ORDER
Buy 0.01 BTC with TP at 80000 and SL at 70000PLACES ORDER
Place a limit buy on ETH 0.1 at $2,300PLACES ORDER

Manage Positions

Close positions, set TP/SL, cancel orders.

5
Close my BTC positionPOSITIONS
Close my SOL positionPOSITIONS
Set take profit on my ETH long at $2,500POSITIONS
Put a stop loss on BTC at $70,000POSITIONS
Cancel order 308830202ACCOUNT

Browse & Create Patterns

List, inspect, and author YAML trading patterns.

7
List my patternsPATTERNS
Show me the funding-carry-btc patternPATTERNS
Show me the price-breakout-btc patternPATTERNS
What patterns do I have?PATTERNS
Write me a pattern that longs BTC when funding is deeply negative, call it my-carry-btcREADY
Create a pattern called my-breakout that longs BTC when price breaks above 75000 with 3x leverageREADY
Save a pattern that shorts ETH when momentum is above 0.7, 2x leverage, call it overbought-ethREADY

Test & Run Patterns

Evaluate patterns live, simulate entries, and backtest against history.

8
Does my funding-carry-btc pattern match right now?PATTERNS
Run my price-breakout-btc pattern against the current marketPATTERNS
Check if any of my patterns are triggeringPATTERNS
Simulate my funding-carry-btc patternPATTERNS
What would happen if I entered with my price-breakout-btc pattern?PATTERNS
Backtest price-breakout-btc over 30 daysPATTERNS
How did my price-breakout-btc pattern perform over the last 60 days?PATTERNS
Backtest all my price-based patterns and compare win ratesMULTI-STEP

Pattern Performance

Track win rates and P&L per pattern over time.

3
How is my funding-carry-btc pattern performing?JOURNAL
Show me win rate per patternJOURNAL
Which pattern makes me the most money?JOURNAL

Agent & Safety

Guardrails, spending limits, and audit trail.

4
What are my guardrail settings?ACCOUNT
How much of my daily budget have I used?ACCOUNT
Show me the agent audit logACCOUNT
What did the agent do today?ACCOUNT

Multi-Step Workflows

Complex requests where Claude chains multiple tools automatically.

13
Scan for opportunities and suggest a tradeMULTI-STEP
Run all my patterns and tell me what's matchingMULTI-STEP
I want to do a funding carry trade — find the best opportunityMULTI-STEP
Review my portfolio and suggest what to closeMULTI-STEP
Write me a pattern, backtest it, and if it looks good, run itMULTI-STEP
Compare my BTC and ETH positions — which should I add to?MULTI-STEP
Create a conservative long pattern for SOL, test it over 30 daysMULTI-STEP
What's the safest trade I can make right now based on funding?MULTI-STEP
Am I at risk of liquidation on any position?MULTI-STEP
Morning briefing — balance, positions, funding, pattern matchesMULTI-STEP
End of day report — P&L, trades, agent activityMULTI-STEP
Help me build a pattern from scratchMULTI-STEP
Is it a good time to long BTC?MULTI-STEP

Pro tip

You don't need to memorize tool names. Just talk naturally — Claude figures out which tools to call. Start with READY prompts (work instantly), then place a trade to unlock POSITIONS prompts.