pumpfun-wallets-mcp

Pumpfun Wallets MCP

An MCP server that analyzes wallets’ trading activity and profitability on Pump.fun and PumpSwap.

Features

• Total Wallets: Retrieve the total number of wallets on Pumpfun and Pumpswap.
• Top Profitable Wallets: Fetch the top wallets by realized profit over the last 30 days, with rank, wallet address, profit, and last transaction timestamp.
• Top Trading Wallets: Get the top wallets by all-time trading volume, including trade count and total volume in USD.
• Wallet Distribution: View the distribution of wallets by trading volume tiers, excluding bots, for insights into trading activity.
• Tabulated Output: Returns data in a clean, tabulated string format for easy readability.

Prerequisites

• Python 3.10+
• A valid Dune Analytics API key

Installation

1. Clone the Repository:
   git clone https://github.com/kukapay/pumpfun-wallets-mcp.git cd pumpfun-wallets-mcp
2. Install Dependencies:
   uv sync
3. Installing to Claude Desktop: Install the server as a Claude Desktop application:
   uv run mcp install main.py --name "pumpfun-wallets-mcp"
   Configuration file as a reference:
   { "mcpServers": { "Pumpfun Wallets": { "command": "uv", "args": [ "--directory", "/path/to/pumpfun-wallets-mcp", "run", "main.py" ], "env": { "DUNE_API_KEY": "dune_api_key"} } } }
   Replace /path/to/pumpfun-wallets-mcp with your actual installation path, and dune_api_key with your API key from Dune Analytics.

Tools

The server provides the following tools, accessible via the MCP interface or API:

get_total_wallets()

• Description: Retrieves the total number of wallets on Pumpfun and Pumpswap.
• Returns: Integer (total wallet count, or 0 on error).
• Example:

get_alpha_wallets(limit: int = 100)

• Description: Fetches the top profitable wallets for the last 30 days, including rank, wallet address, realized profit (USD), and last transaction timestamp.
• Parameters: limit (optional, default: 100) - Maximum number of wallets to return.
• Returns: Tabulated string with wallet data, or empty string on error.
• Example:

Output:

get_trading_wallets(limit: int = 10)

• Description: Retrieves the top wallets by all-time trading volume, including rank, wallet address, trade count, and total volume (USD).
• Parameters: limit (optional, default: 10) - Maximum number of wallets to return.
• Returns: Tabulated string with wallet data, or empty string on error.
• Example:

Output:

get_trading_wallet_distribution()

• Description: Fetches the distribution of wallets by trading volume tiers (excluding bots).
• Returns: Tabulated string with volume tiers and wallet counts, or empty string on error.
• Example:

Output:

License

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