openpump-solana-mcp

# 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](https://openpump.io)
2. Go to Dashboard > API Keys
3. Create a new key (starts with `op_sk_live_`)

### 2. Set the Environment Variable

```bash
export OPENPUMP_API_KEY="op_sk_live_YOUR_KEY_HERE"
```

### 3. Add MCP Server

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

```bash
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):**

```json
{
  "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):**

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

## Available Tools (57)

### Token Creation (2)

| Tool | Description |
|------|-------------|
| `create-token` | Launch a new token on pump.fun with name, symbol, description, and image |
| `bundle-launch` | Atomically create a token AND coordinate multi-wallet buys via Jito bundles |

### Trading (7)

| Tool | Description |
|------|-------------|
| `buy-token` | Buy a pump.fun token with SOL (single wallet). `amountSol` is a decimal SOL string (e.g. `"0.1"`) |
| `sell-token` | Sell a token position back to SOL. Use `tokenAmount: "all"` for entire balance |
| `bundle-buy` | Multi-wallet buy of an existing token via Jito bundles |
| `bundle-sell` | Multi-wallet sell packed into Jito bundles (bonding curve tokens only) |
| `get-token-quote` | Price quote for buy or sell without executing. `solAmount` in lamports string for buys |
| `estimate-bundle-cost` | Preview total SOL required for a bundle launch before executing |
| `claim-creator-fees` | Claim accumulated pump.fun creator fees for a wallet address |

### Transfers (2)

| Tool | Description |
|------|-------------|
| `transfer-sol` | Send SOL to any Solana address. `amountSol` is decimal SOL string. 10 SOL cap per call. Supports `dryRun` |
| `transfer-token` | Send SPL tokens to any Solana address. `tokenAmount` in raw base units or `"all"` |

### Wallet Management (5)

| Tool | Description |
|------|-------------|
| `create-wallet` | Create a new HD-derived custodial wallet with optional label |
| `batch-create-wallets` | Create 2-50 wallets in one action with auto-numbered labels |
| `get-aggregate-balance` | Sum SOL across all user wallets |
| `get-wallet-deposit-address` | Get deposit address and funding instructions for a wallet |
| `get-wallet-transactions` | Paginated transfer history (buy/sell/transfer) for a wallet |

### Market Making (13)

| Tool | Description |
|------|-------------|
| `mm-create-pool` | Create a wallet pool with N wallets grouped under a label (2-50 wallets) |
| `mm-list-pools` | List all wallet pools for the user |
| `mm-pool-status` | Aggregate status: per-wallet SOL and token balances, totals |
| `mm-fund-pool` | Distribute SOL from source wallet to all pool wallets. Supports multi-hop obfuscation (hops 0-3) |
| `mm-consolidate-pool` | Sweep all funds from pool wallets back to a single target wallet |
| `mm-start-session` | Start autonomous market making on a token with configurable strategy |
| `mm-stop-session` | Stop a running session. Positions are NOT auto-liquidated |
| `mm-pause-session` | Pause a session (retains position and config) |
| `mm-resume-session` | Resume a paused session from where it left off |
| `mm-session-status` | Detailed session stats: config, live data, recent trades |
| `mm-list-sessions` | List all sessions, optionally filter by status |
| `mm-update-strategy` | Hot-update strategy params on a running/paused session |
| `mm-get-pnl` | P&L report: WAC cost basis, realized/unrealized P&L, slippage-adjusted sell simulation, ROI% |

### Sniping (7)

| Tool | Description |
|------|-------------|
| `snipe-start` | Create a monitor that auto-buys new tokens matching criteria (ticker pattern, market cap, risk filters) |
| `snipe-stop` | Stop a snipe monitor permanently |
| `snipe-pause` | Pause a snipe monitor (resume later) |
| `snipe-resume` | Resume a paused snipe monitor |
| `snipe-update` | Update criteria on an active or paused monitor |
| `snipe-status` | Detailed status including criteria, buy count, state |
| `snipe-list` | List all snipe monitors, optionally filter by status |

### Stop Loss (4)

| Tool | Description |
|------|-------------|
| `stop-loss-set` | Create a stop-loss monitor. Auto-sells when market cap drops below trigger |
| `stop-loss-remove` | Remove a stop-loss monitor |
| `stop-loss-list` | List all stop-loss monitors |
| `stop-loss-status` | Detailed status of a specific stop-loss |

### Vanity Addresses (4)

| Tool | Description |
|------|-------------|
| `estimate-vanity-cost` | Estimate credits for a vanity pattern before ordering |
| `order-vanity-address` | Order a vanity wallet or mint address (prefix, suffix, or contains) |
| `list-vanity-jobs` | List vanity mining jobs (newest first) |
| `get-vanity-job` | Check status of a specific vanity job. Wallet auto-added on completion |

### Spam Launch (3)

| Tool | Description |
|------|-------------|
| `spam-launch` | Create multiple tokens in rapid succession from one wallet (1-100) |
| `estimate-spam-cost` | Estimate total SOL and credits for a spam launch |
| `cancel-spam-launch` | Cancel a running spam launch job |

### Information (9)

| Tool | Description |
|------|-------------|
| `get-token-info` | Bonding curve state: price, market cap, graduation status |
| `get-token-market-info` | Rich analytics: volume, buy/sell counts, risk metrics (snipers, bundlers, insiders) |
| `list-my-tokens` | All tokens launched by the authenticated user |
| `get-token-holdings` | Which wallets hold a specific token. Omit mint to see ALL holdings |
| `get-wallet-balance` | Live SOL + token balances for a single wallet |
| `list-wallets` | All wallets with public keys, labels, derivation index |
| `get-creator-fees` | Check accumulated pump.fun creator fees. Omit address to check all wallets |
| `get-jito-tip-levels` | Current Jito MEV tip amounts per priority level (refreshed every 20s) |

### Job Management (2)

| Tool | Description |
|------|-------------|
| `poll-job` | Check status of async operations. Poll every 2s until "completed" or "failed" |
| `cancel-job` | Cancel a running async job |

## 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](https://openpump.io)
- npm: [@openpump/mcp](https://www.npmjs.com/package/@openpump/mcp)