> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gank.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# mcp / ai

> autonomous ai trading via mcp

# mcp integration

full [mcp](https://modelcontextprotocol.io) server. 30+ tools. plug it into any mcp-compatible client — claude desktop, windsurf, cursor, [openclaw](/platform/openclaw-guide), whatever. the ai gets the same capabilities you have in the dashboard.

```
npm i gank-mcp-server@latest
```

## setup

grab an api key from [gank.dev](https://gank.dev) → profile → api keys.

### claude desktop

add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "gank": {
      "command": "npx",
      "args": ["-y", "gank-mcp-server"],
      "env": {
        "GANK_API_KEY": "your-api-key"
      }
    }
  }
}
```

### windsurf / cursor

same format — add to your mcp config file.

### openclaw

see the [openclaw guide](/platform/openclaw-guide) for the full walkthrough.

## tools — trading

| tool              | what it does                                                         |
| ----------------- | -------------------------------------------------------------------- |
| `buy_token`       | buy a token with sol. needs `regular` wallet.                        |
| `sell_token`      | sell % of holdings. works with `regular`, `dev`, or `bundle` wallet. |
| `get_token_price` | current price in sol and usd.                                        |

## tools — wallets

| tool                  | what it does                                                       |
| --------------------- | ------------------------------------------------------------------ |
| `list_wallets`        | all your wallets grouped by type.                                  |
| `get_wallet_balance`  | sol + token holdings for one wallet.                               |
| `get_balances_batch`  | batch sol balances for multiple wallets.                           |
| `create_wallet`       | generate a new keypair. call `save_wallet` after.                  |
| `save_wallet`         | assign a wallet to a type (dev/regular/snipe/swarm/volume/bundle). |
| `fund_wallet`         | transfer sol between wallets. 10 sol max per call.                 |
| `consolidate_wallets` | sell tokens + sweep sol to one destination.                        |
| `vamp_all`            | sell everything, close accounts, sweep all sol.                    |

## tools — privacy swap

| tool                    | what it does                                                                     |
| ----------------------- | -------------------------------------------------------------------------------- |
| `privacy_swap_quote`    | get a quote for sol→xmr→sol swap. shows estimated output and fees. min 0.2 sol.  |
| `privacy_swap_initiate` | start a privacy swap. source/dest arrays must match 1:1. \~45 min. irreversible. |
| `privacy_swap_status`   | check progress of active swap operations.                                        |
| `privacy_swap_history`  | past swap operations with final amounts.                                         |

## tools — launches

| tool                  | what it does                                                  |
| --------------------- | ------------------------------------------------------------- |
| `reserve_mint`        | reserve a vanity `...pump` contract address.                  |
| `launch_token`        | launch on pump.fun with optional dev buy. needs `dev` wallet. |
| `get_launch_status`   | check launch status by id.                                    |
| `get_launch_by_token` | look up launch by token mint.                                 |
| `get_launch_history`  | your past launches.                                           |
| `execute_snipe`       | snipe a token. needs `snipe` wallet.                          |
| `swarm_buy`           | parallel multi-wallet buy. needs `swarm` wallets.             |
| `run_volume_bot`      | start volume generation. needs `volume` wallets.              |
| `stop_volume_bot`     | stop a running volume bot by session id.                      |

## tools — info

| tool                 | what it does                                                         |
| -------------------- | -------------------------------------------------------------------- |
| `get_positions`      | all token positions across all wallets.                              |
| `get_account_info`   | account details — handle, referral code, etc.                        |
| `get_user_stats`     | level, points, total volume.                                         |
| `get_pending_fees`   | unclaimed creator fees from pump.fun.                                |
| `claim_creator_fees` | claim all pending creator fees.                                      |
| `search_tokens`      | search by name, symbol, or address.                                  |
| `upload_image`       | upload token image to ipfs. returns metadata\_uri for launch\_token. |

## wallet types

each tool enforces the correct wallet type. use the wrong one and it gets rejected.

| type      | used by                   |
| --------- | ------------------------- |
| `dev`     | `launch_token`            |
| `regular` | `buy_token`, `sell_token` |
| `snipe`   | `execute_snipe`           |
| `swarm`   | `swarm_buy`               |
| `volume`  | `run_volume_bot`          |
| `bundle`  | bundle buys (launch flow) |

## isolation

ai wallets are separate from your manually managed wallets. the ai can't touch human-created wallets, and vice versa. everything the ai does shows in the live feed tagged as ai activity.

## constraints

* 10 sol max per `fund_wallet` call
* 100 wallets max per batch generation
* all actions logged in the dashboard live feed
* api key revocable at any time from the dashboard
* ai wallets isolated from human wallets