Solana Jupiter Swap MCP

A Model-Context-Protocol server for interacting with Solana blockchain, including wallet operations and token swaps using Jupiter aggregator. This server provides simple RPC endpoints for Solana operations, allowing secure interactions through environment variables.

Features

• Check SOL account balances
• Get detailed account information
• Transfer SOL between accounts
• View SPL token balances
• Get your wallet address from private key
• Swap tokens using Jupiter (Best price routing across all Solana DEXs)

Supported Tools

| Method | Description | Parameters | |-------------------|------------------------------------------------------------------|--------------------------------------------------------------------------------------------| | getMyAddress | Get your Solana public address and balances from private key | none | | getBalance | Get SOL balance for a Solana address | address (string, required) | | getAccountInfo | Get detailed account info for a Solana address | address (string, required), encoding ("base58" | "base64" | "jsonParsed", optional) | | getSplTokenBalances | Get SPL token balances for a Solana address | address (string, required) | | getSwapQuote | Get best swap quote from Jupiter DEX aggregator | inputMint (string), outputMint (string), amount (string), slippageBps (number, optional) | | executeSwap | Execute a token swap using Jupiter DEX aggregator | inputMint (string), outputMint (string), amount (string), slippageBps (number, optional) | | transfer | Transfer SOL from your keypair to another address | toAddress (string), amount (number, in SOL) |

Usage Example

Example: Get My Address

{
  "method": "getMyAddress",
  "params": {}
}

Example: Get Balance

{
  "method": "getBalance",
  "params": { "address": "<SOL_ADDRESS>" }
}

Example: Get SPL Token Balances

{
  "method": "getSplTokenBalances",
  "params": { "address": "<SOL_ADDRESS>" }
}

Example: Get Swap Quote

{
  "method": "getSwapQuote",
  "params": {
    "inputMint": "So11111111111111111111111111111111111111112", // SOL
    "outputMint": "Es9vMFrzaCERa8F1tq8QzZ6pA7r6zG9aG9aG9aG9aG9a", // USDT
    "amount": "1000000", // in lamports (1 SOL = 1_000_000_000 lamports)
    "slippageBps": 50
  }
}

Example: Execute Swap

{
  "method": "executeSwap",
  "params": {
    "inputMint": "So11111111111111111111111111111111111111112",
    "outputMint": "Es9vMFrzaCERa8F1tq8QzZ6pA7r6zG9aG9aG9aG9aG9a",
    "amount": "1000000",
    "slippageBps": 50
  }
}

Example: Transfer SOL

{
  "method": "transfer",
  "params": {
    "toAddress": "<DESTINATION_SOL_ADDRESS>",
    "amount": 0.01
  }
}

Environment Variables (JSON Example)

{
  "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
  "SOLANA_PRIVATE_KEY": "your-base58-encoded-solana-private-key"
}

Integration Example (claude_desktop_config.json)

{
  "mcpServers": {
    "solana-jupiter-swap": {
      "command": "node",
      "args": [
        "/PATH/TO/solana-jupiter-swap/build/index.js"
      ],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
        "SOLANA_PRIVATE_KEY": "your-base58-encoded-solana-private-key"
      },
      "transportType": "stdio"
    }
  }
}

Setup

1. Clone and install dependencies: