Pumpswap MCP

What kukapay/pumpswap-mcp MCP server does

The kukapay/pumpswap-mcp MCP server exposes PumpSwap operations to MCP-compatible AI clients. It supports token purchases funded with SOL, token sales that return SOL, current token price lookups, and formatted pool information for a token mint.

Trading operations accept a PumpSwap token mint and an amount. Buy requests also support configurable slippage and transaction priority fees through environment variables. Sell requests use their own slippage setting. Price and pool queries are read-oriented operations and do not require a transaction to be submitted.

How it works

The project is a local Python server. It uses uv for dependency management and execution, then listens for MCP commands when started with uv run main.py. The server connects to the Solana network through the RPC URL in HTTPS_RPC_ENDPOINT.

Buy and sell operations require transaction signing. The configured Solana private key is used for this purpose, and the tool responses can include a transaction ID, traded amount, and token price. Queries use a token mint address to identify the asset and its associated PumpSwap pool.

The kukapay/pumpswap-mcp MCP server is intended for direct interaction with PumpSwap rather than general Solana portfolio management. The supplied material does not document wallet balances, transaction history, token discovery, or support for other exchanges.

Setup and configuration

The README specifies Python 3.13 or newer, although its status badge also references Python 3.10+. It requires uv and a Solana RPC endpoint, such as the public Solana mainnet endpoint. Installation consists of cloning the repository, entering its directory, and running uv sync to install dependencies.

Configuration is loaded from a .env.private file in the project root. The available variables are:

• HTTPS_RPC_ENDPOINT: Solana RPC endpoint URL. The documented default is https://api.mainnet-beta.solana.com.
• BUY_SLIPPAGE: Buy-side slippage tolerance, documented as 0.3 by default.
• SELL_SLIPPAGE: Sell-side slippage tolerance, documented as 0.1 by default.
• SWAP_PRIORITY_FEE: Transaction priority fee in lamports, documented as 1500000 by default.
• PRIVATE_KEY: Solana private key used to sign transactions. This value is required.

Start the server from the cloned project with uv run main.py.

Tools and capabilities

The documented MCP tools are:

• buy_token(mint, sol_amount, user_private_key): buys tokens using SOL.
• sell_token(mint, token_amount, user_private_key): sells tokens for SOL.
• get_token_price(mint): returns the current token price in SOL.
• get_pool_data(mint): returns formatted pool fields, including mint addresses, account addresses, creator, index, bump, and LP supply.

The README examples use PumpSwap token mint addresses and demonstrate natural-language requests for each operation.

Limitations and notes

This project handles private keys and can submit on-chain DeFi transactions. Keep .env.private protected and do not share the private key. The README warns that users are responsible for financial losses and security issues arising from use of the software.

The server depends on the selected Solana RPC endpoint and configured transaction parameters. Slippage, priority fees, and the private key should be reviewed before enabling automated trading. The repository is licensed under MIT.