# Advan MCP server

> Enables AI agents to perform non-custodial Solana trading, including Jupiter quotes, swap transaction building, token risk analysis, and portfolio tracking.

- Repository: https://github.com/solaradex/Advan
- Page: https://hostedmcp.org/servers/solaradex/advan
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 0.1.0

## Install

### Claude Code

```sh
claude mcp add --env 'SOLANA_RPC_URL=<YOUR_SOLANA_RPC_URL>' --env 'JUPITER_API_KEY=<YOUR_JUPITER_API_KEY>' advan -- npx -y advan-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "advan": {
      "command": "npx",
      "args": [
        "-y",
        "advan-mcp"
      ],
      "env": {
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "JUPITER_API_KEY": "<YOUR_JUPITER_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "advan": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "advan-mcp"
      ],
      "env": {
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "JUPITER_API_KEY": "<YOUR_JUPITER_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"advan","type":"stdio","command":"npx","args":["-y","advan-mcp"],"env":{"SOLANA_RPC_URL":"<YOUR_SOLANA_RPC_URL>","JUPITER_API_KEY":"<YOUR_JUPITER_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "advan": {
      "command": "npx",
      "args": [
        "-y",
        "advan-mcp"
      ],
      "env": {
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "JUPITER_API_KEY": "<YOUR_JUPITER_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add advan --env 'SOLANA_RPC_URL=<YOUR_SOLANA_RPC_URL>' --env 'JUPITER_API_KEY=<YOUR_JUPITER_API_KEY>' -- npx -y advan-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.advan]
command = "npx"
args = ["-y", "advan-mcp"]

[mcp_servers.advan.env]
SOLANA_RPC_URL = "<YOUR_SOLANA_RPC_URL>"
JUPITER_API_KEY = "<YOUR_JUPITER_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'SOLANA_RPC_URL=<YOUR_SOLANA_RPC_URL>' -e 'JUPITER_API_KEY=<YOUR_JUPITER_API_KEY>' advan npx -- -y advan-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "advan": {
      "command": "npx",
      "args": [
        "-y",
        "advan-mcp"
      ],
      "env": {
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "JUPITER_API_KEY": "<YOUR_JUPITER_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SOLANA_RPC_URL` | yes | yes | Solana RPC endpoint (mainnet) |
| `JUPITER_API_KEY` | no | yes | Jupiter API key (optional, raises rate limits) |
| `ADVAN_HTTP_URL` | no | no |  |
| `CDP_API_KEY_ID` | no | no |  |
| `CDP_API_KEY_SECRET` | no | no |  |
| `JUPITER_REFERRAL_ACCOUNT` | no | no |  |
| `JUPITER_REFERRAL_FEE_BPS` | no | no |  |
| `JUPITER_REFERRAL_TOKEN_ACCOUNT_SOL` | no | no |  |
| `JUPITER_REFERRAL_TOKEN_ACCOUNT_USDC` | no | no |  |
| `JUPITER_REFERRAL_TOKEN_ACCOUNT_USDT` | no | no |  |
| `MAX_SLIPPAGE_BPS` | no | no |  |
| `MAX_TRADE_USD` | no | no |  |
| `REFERRAL_PAYER_PUBKEY` | no | no |  |
| `SKIP_LIVE` | no | no |  |
| `SOLANA_KEYPAIR_PATH` | no | no |  |
| `X402_CLIENT_RPC_URL` | no | no |  |
| `X402_NETWORK` | no | no |  |
| `X402_PAY_TO` | no | no |  |
| `X402_PRICE_USD` | no | no |  |
| `X402_RPC_URL` | no | no |  |

## Tools (4)

- `get_quote`: Free Jupiter Swap API V2 quote (GET /swap/v2/order, no taker). Returns amounts, route, slippage, and referral fee fields. Does not return a transaction.
- `build_swap_tx`: Free. Returns an UNSIGNED base64 transaction for the taker wallet to sign. Advan never signs and never holds keys. Default (selfBroadcast false) keeps JupiterZ routes, which need Jupiter POST /swap/v2/execute to add the market-maker co-signature. Pass selfBroadcast true to exclude jupiterz so the taker can broadcast the signed transaction.
- `token_risk`: Paid token risk report ($0.01 USDC via x402 exact on solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1). Combines RPC mint/freeze authority, Jupiter Tokens V2, and RugCheck. Ordinary MCP clients that cannot pay receive a payment-required error.
- `wallet_portfolio`: Paid wallet portfolio ($0.01 USDC via x402 exact). SOL plus SPL Token and Token-2022 balances, priced with Jupiter Price V3.

## FAQ

### Is Advan custodial?

No, the server is non-custodial. It never signs transactions or loads trading keys; it returns unsigned transactions for the user to sign.

### Can I use Advan with Claude Desktop or Cursor?

Yes, but paid tools like token_risk and wallet_portfolio require an x402-aware client to handle payments.
