# kukapay/pumpswap-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/kukapay/pumpswap-mcp  
**GitHub Stars:** 7  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kukapay-pumpswap-mcp

## Description
Enabling AI agents to interact with PumpSwap for real-time token swaps and automated on-chain trading.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "pumpswap-mcp": {
    "command": "npx",
    "args": ["-y","kukapay-pumpswap-mcp"],
    "env": {
      "HTTPS_RPC_ENDPOINT": "",
      "BUY_SLIPPAGE": "",
      "SELL_SLIPPAGE": "",
      "SWAP_PRIORITY_FEE": "",
      "PRIVATE_KEY": ""
    }
  }
}
```

**Requires environment variables:** `HTTPS_RPC_ENDPOINT`, `BUY_SLIPPAGE`, `SELL_SLIPPAGE`, `SWAP_PRIORITY_FEE`, `PRIVATE_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/kukapay-pumpswap-mcp/readme_