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 markets”READY
“What's the BTC price right now?”READY
“How's ETH doing?”READY
“Show me the SOL order book”READY
“What's the spread on BTC?”READY
“Which markets have the highest volume?”READY
“Find me markets with negative funding”READY

Funding Rates

Funding rates, APR calculations, and historical data.

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

Account & Positions

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

9
“Show my account balance”ACCOUNT
“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 summary”ACCOUNT
“Show my win rate from Pacifica history”ACCOUNT
“Show my recent trades”ACCOUNT
“Show my ETH trade history”ACCOUNT

Place Trades

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

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

Manage Positions

Close positions, set TP/SL, cancel orders.

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

Browse & Create Patterns

List, inspect, and author YAML trading patterns.

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

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 market”PATTERNS
“Check if any of my patterns are triggering”PATTERNS
“Simulate my funding-carry-btc pattern”PATTERNS
“What would happen if I entered with my price-breakout-btc pattern?”PATTERNS
“Backtest price-breakout-btc over 30 days”PATTERNS
“How did my price-breakout-btc pattern perform over the last 60 days?”PATTERNS
“Backtest all my price-based patterns and compare win rates”MULTI-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 pattern”JOURNAL
“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 log”ACCOUNT
“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 trade”MULTI-STEP
“Run all my patterns and tell me what's matching”MULTI-STEP
“I want to do a funding carry trade — find the best opportunity”MULTI-STEP
“Review my portfolio and suggest what to close”MULTI-STEP
“Write me a pattern, backtest it, and if it looks good, run it”MULTI-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 days”MULTI-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 matches”MULTI-STEP
“End of day report — P&L, trades, agent activity”MULTI-STEP
“Help me build a pattern from scratch”MULTI-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.