kukapay/pumpswap-mcp

PumpSwap MCP Server

An MCP server that enables AI agents to interact with PumpSwap for real-time token swaps and automated on-chain trading.

Features

• Buy Tokens: Purchase tokens using SOL with customizable slippage and priority fees.
• Sell Tokens: Sell tokens for SOL with configurable parameters.
• Token Price Query: Retrieve current token prices in SOL.
• Pool Data Retrieval: Fetch and display detailed pool information for a given token mint.

Prerequisites

• Python 3.13 or higher
• uv for dependency management and script execution
• Solana RPC endpoint (e.g., https://api.mainnet-beta.solana.com)
• A valid Solana private key for transaction signing

Installation

1. Clone the Repository:

   git clone https://github.com/kukapay/pumpswap-mcp.git
   cd pumpswap-mcp
   

2. Install uv: If uv is not installed, follow the official uv installation guide. For example:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. Set Up Dependencies: Use uv to install dependencies:

   uv sync
   

4. Configure Environment Variables: Create a .env.private filein the project root with the following variables:

   HTTPS_RPC_ENDPOINT=https://api.mainnet-beta.solana.com
   BUY_SLIPPAGE=0.3
   SELL_SLIPPAGE=0.1
   SWAP_PRIORITY_FEE=1500000
   PRIVATE_KEY=your-solana-private-key
   

   Replace your-solana-private-key with your actual Solana private key.