OpenPump MCP Server

Trade pump.fun tokens, manage Solana wallets, run market making bots, snipe new tokens, and monitor positions via MCP.

Setup

1. Get Your API Key

1. Sign up at openpump.io
2. Go to Dashboard > API Keys
3. Create a new key (starts with op_sk_live_)

2. Set the Environment Variable

export OPENPUMP_API_KEY="op_sk_live_YOUR_KEY_HERE"

3. Add MCP Server

Claude Code (HTTP transport -- no local process):

claude mcp add --transport http openpump https://openpump.io/api/mcp \
  --header "Authorization: Bearer op_sk_live_YOUR_KEY_HERE"

Claude Desktop / any MCP client (stdio via npx):

{
  "mcpServers": {
    "openpump": {
      "command": "npx",
      "args": ["-y", "@openpump/mcp@latest"],
      "env": {
        "OPENPUMP_API_KEY": "op_sk_live_YOUR_KEY_HERE"
      }
    }
  }
}

HTTP transport (remote, no local process):

{
  "mcpServers": {
    "openpump": {
      "url": "https://mcp.openpump.io/mcp",
      "headers": {
        "Authorization": "Bearer ${OPENPUMP_API_KEY}"
      }
    }
  }
}

Available Tools (57)

Token Creation (2)

Trading (7)

Transfers (2)

Wallet Management (5)

Market Making (13)

Sniping (7)

Stop Loss (4)

Vanity Addresses (4)

Spam Launch (3)

Information (9)

Job Management (2)

Workflows

1. Launch a Token

1. create-wallet (label: "launch-wallet")
2. Fund the wallet with SOL (use get-wallet-deposit-address for the address)
3. create-token (name, symbol, description, imageUrl)
4. poll-job (wait for "completed")
5. get-token-info (verify token is live)

2. Bundle Launch (Create + Multi-Wallet Buy)

1. create-wallet (dev wallet)
2. batch-create-wallets (count: 5, labelPrefix: "buyer")
3. Fund all wallets with SOL
4. estimate-bundle-cost (buyWalletCount: 5, devBuyAmountSol: "0.1", walletBuyAmounts)
5. bundle-launch (devWalletId, buyWalletIds, tokenParams, amounts, confirm: true)
6. poll-job (wait for "completed")
7. get-token-holdings (mint) -- verify all wallets hold the token

3. Buy and Sell Flow

1. list-wallets (find walletId with SOL balance)
2. get-token-quote (action: "buy", solAmount: "100000000") -- 0.1 SOL in lamports
3. buy-token (mint, walletId, amountSol: "0.1") -- decimal SOL string
4. get-token-holdings (mint) -- verify purchase
5. get-token-quote (action: "sell", tokenAmount from holdings)
6. sell-token (mint, walletId, tokenAmount or "all")

4. Market Making

1. mm-create-pool (label: "mm-pool", walletCount: 10)
2. mm-fund-pool (poolId, sourceWalletId, totalAmountSol: 2.5, hops: 2)
3. mm-pool-status (poolId) -- verify funding
4. mm-start-session (mint, walletPoolId, config: {
     amountRange: ["5000000", "50000000"],  -- 0.005 to 0.05 SOL in lamports
     maxPositionSol: "1000000000",           -- 1 SOL max
     netBias: 0.5,                           -- balanced buys/sells
     intervalRange: [10, 45],                -- 10-45s between trades
     confirm: true
   })
5. mm-session-status (sessionId) -- monitor
6. mm-get-pnl (sessionId) -- check profitability
7. mm-stop-session (sessionId) -- when done
8. mm-consolidate-pool (poolId, targetWalletId) -- recover funds

5. Sniping New Tokens

1. list-wallets -- pick a funded wallet
2. snipe-start (walletId, tickerPattern: "PEPE*", buyAmountSol: 0.05, {
     maxDevPercent: 10,       -- filter rugs
     maxSniperCount: 5,       -- avoid crowded launches
     maxBuys: 3,              -- stop after 3 buys
     confirm: true
   })
3. snipe-status (monitorId) -- check matches
4. snipe-update (monitorId, ...) -- adjust criteria live
5. snipe-stop (monitorId) -- when done

6. Stop Loss Protection

1. get-token-holdings (mint) -- confirm position
2. get-token-market-info (mint) -- check current market cap
3. stop-loss-set (walletId, mint, triggerMarketCapSol: 5.0, confirm: true)
4. stop-loss-status (stopLossId) -- verify active
5. stop-loss-remove (stopLossId) -- cancel if no longer needed

7. Check Portfolio

1. list-wallets -- see all wallets
2. get-aggregate-balance -- total SOL across wallets
3. get-token-holdings -- all token positions (omit mint for everything)
4. get-token-market-info (per mint) -- current prices and risk metrics

8. Claim Creator Fees

1. get-creator-fees -- check all wallets for accumulated fees
2. claim-creator-fees (creatorAddress)
3. get-wallet-balance (walletId) -- verify SOL increased

9. Transfer SOL Out

1. get-wallet-balance (walletId) -- check available SOL
2. transfer-sol (walletId, toAddress, amountSol: "1.0", dryRun: true) -- preview
3. transfer-sol (walletId, toAddress, amountSol: "1.0", confirm: true) -- execute

10. Vanity Address

1. estimate-vanity-cost (pattern: "PUMP", patternType: "prefix")
2. order-vanity-address (pattern: "PUMP", patternType: "prefix")
3. get-vanity-job (jobId) -- poll until "completed"
4. list-wallets -- new vanity wallet appears automatically

Safety Guardrails

All trading actions require explicit user confirmation before execution.

1. Always check balances first. Run get-wallet-balance or get-aggregate-balance before any trade or transfer.

2. Use quotes before trading. Call get-token-quote to preview expected output and price impact.

3. Confirm large trades explicitly. Bundle operations, MM sessions, and snipe monitors all require confirm: true. Review parameters first.

4. Verify addresses on transfers. Double-check destination addresses. Transfers are irreversible on Solana.

5. Use dryRun for transfers. Both transfer-sol and transfer-token support dryRun: true.

6. Check risk metrics. Use get-token-market-info to check sniper count, bundler activity, and insider percentage before buying.

7. Set stop-losses. Use stop-loss-set to protect positions from sudden drops.

8. Bundle slippage. bundle-launch packs multiple wallets per TX. Use 2500+ bps slippage (25%) for bundles, not the default 500 bps.

9. MM drawdown. Market making sessions have a maxDrawdownPercent circuit breaker (default 15%). Session auto-stops if losses exceed this.

10. Transfer cap. transfer-sol has a 10 SOL cap per call. Split larger amounts into multiple calls.

11. Monitor async ops. After create-token, bundle-launch, or spam-launch, poll every 2 seconds. Jobs expire after 10 minutes.

Key Concepts

• SOL amounts: amountSol params accept decimal SOL strings ("0.1" = 0.1 SOL). NOT lamports.
• Lamports: Some params (get-token-quote solAmount, mm-start-session amountRange) use lamports as integer strings (1 SOL = 1,000,000,000).
• Token base units: Token amounts use raw base units. Use the exact "amount" string from get-token-holdings.
• Custodial wallets: HD-derived, managed by the platform. Cannot import external keys.
• Bonding curve: pump.fun tokens trade on a bonding curve until graduation to PumpSwap. bundle-sell only works on bonding curve tokens.
• Jito bundles: Atomic, same-block execution. First bundle is guaranteed atomic; overflow wallets go into subsequent bundles.
• Wallet pools: Groups of wallets for market making. Multi-hop funding breaks on-chain clustering.

Links

• Website: openpump.io
• npm: @openpump/mcp