convez.ai
MCP ServerIntegração & APIsAvançado
kukapay

PumpSwap MCP Server

kukapay/pumpswap-mcp

Automatize trading de tokens Solana via IA com PumpSwap

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra agentes de IA com a plataforma PumpSwap para realizar swaps de tokens em tempo real e trading automatizado on-chain na rede Solana. Oferece ferramentas para compra/venda de tokens, consulta de preços e análise de dados de pools.

Instalação

$npx convez-ai kukapay/pumpswap-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
6
Acompanhando
1
Saúde
42%
Último commit
há 1 ano
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Execução automatizada de swaps de tokens via agentes Claude
  • Trading algorítmico com parametrização de slippage e taxas
  • Monitoramento em tempo real de preços e dados de liquidez de tokens

Veredito

Ferramenta robusta para operações de DeFi automatizadas, mas exige expertise em Solana, gerenciamento de chaves privadas e compreensão profunda de trading on-chain. Recomendado apenas para desenvolvedores experientes com conhecimento em blockchain.

README

A tradução para o português deste README ainda está na fila.

PumpSwap MCP Server

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

License Python Status

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.

Usage

Run the MCP Server

Use uv to run the server:

uv run main.py

The server will listen for MCP commands and expose the following tools:

  • buy_token(mint: str, sol_amount: float, user_private_key: str): Buy tokens with SOL.
  • sell_token(mint: str, token_amount: float, user_private_key: str): Sell tokens for SOL.
  • get_token_price(mint: str): Fetch the current token price in SOL.
  • get_pool_data(mint: str): Retrieve formatted pool data for a token.

Buy Tokens

Prompt:

Buy 0.1 SOL worth of tokens with mint address FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump.

This triggers buy_token("FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump", 0.1).

Expected Output:

Buy successful for 0.1 SOL of token FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump
Transaction ID: <transaction-id>
Amount: <token-amount>
Token Price (SOL): <price>

Sell Tokens

Prompt:

Sell 1000 tokens of FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump.

This triggers sell_token("FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump", 1000).

Expected Output:

Sell successful for 1000 tokens of FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump
Transaction ID: <transaction-id>
Amount: <sol-amount>
Token Price (SOL): <price>

Get Token Price

Prompt:

What is the current price of the token with mint FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump?

This triggers get_token_price("FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump").

Expected Output:

The current price of token FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump is <price> SOL.

Get Pool Data

Prompt:

Show me the pool data for the token with mint FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump.

This triggers get_pool_data("FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump").

Expected Output:

PumpPool Data for mint FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump:
Pool Bump: <bump>
Index: <index>
Creator: <creator-pubkey>
Base Mint: <base-mint>
Quote Mint: <quote-mint>
LP Mint: <lp-mint>
Pool Base Token Account: <base-account>
Pool Quote Token Account: <quote-account>
LP Supply: <supply>

Environment Variables

The server uses the following environment variables, loaded from .env.private:

VariableDescriptionDefault Value
HTTPS_RPC_ENDPOINTSolana RPC endpoint URLhttps://api.mainnet-beta.solana.com
BUY_SLIPPAGESlippage tolerance for buy transactions0.3 (30%)
SELL_SLIPPAGESlippage tolerance for sell transactions0.1 (10%)
SWAP_PRIORITY_FEEPriority fee for transactions (in lamports)1500000
PRIVATE_KEYSolana private key for signing transactionsNone (required)

Ensure PRIVATE_KEY is set, as the server will raise an error if it's missing.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Disclaimer

This software interacts with decentralized finance (DeFi) protocols and handles sensitive data like private keys. Use it at your own risk. Ensure your .env.private file is secure and never share your private key. The authors are not responsible for any financial losses or security issues arising from the use of this software.

Ver o original no GitHub

Bom para

Relacionados