home / mcp / pumpfun wallets mcp server

Pumpfun Wallets MCP Server

Provides real-time wallet analytics for Pumpfun and PumpSwap via the MCP interface using Dune Analytics data.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kukapay-pumpfun-wallets-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/pumpfun-wallets-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "DUNE_API_KEY": "YOUR_DUNE_API_KEY"
      }
    }
  }
}

This MCP server analyzes Pump.fun and PumpSwap wallet activity to provide insights on total wallets, profitability, trading volume, and distribution. It returns data in a clean, tabulated format that you can use for analytics, reporting, or decision making.

How to use

You interact with the Pumpfun Wallets MCP through an MCP client to fetch wallet metrics. Use the available tools to retrieve the total wallet count, see the top profitable wallets for the last 30 days, view the top trading wallets by all‑time volume, and inspect the distribution of wallets by trading activity. All outputs are provided as easy‑to‑read tabulated strings.

Primary tools you will use are designed to be called by your MCP client. For example, you can ask for the total number of wallets, request the alpha wallets for the past 30 days, obtain trading wallet rankings, and fetch the trading distribution. Each tool returns a formatted table or a simple value suitable for display in dashboards or reports.

How to install

Prerequisites you need before installing: Python 3.10 or newer, and a valid Dune Analytics API key.

Step 1: Clone the MCP server repository. Then navigate into the project directory.

Step 2: Install and start the MCP runtime as described below.

Step 3: Configure the MCP server using the provided runtime command and environment variable for your setup.

Additional content

Configuration and runtime details are provided to help you run the Pumpfun Wallets MCP smoothly. The server includes an example configuration you can adapt to your environment.

Example configuration to run the MCP within a desktop environment is shown here. It uses the uv runtime to start the server and passes the directory path to the MCP and the main script to execute. Replace the placeholder path with your actual installation path and insert your DUNE API key.

{
  "mcpServers": {
    "Pumpfun Wallets": {
      "command": "uv",
      "args": [ "--directory", "/path/to/pumpfun-wallets-mcp", "run", "main.py" ],
      "env": { "DUNE_API_KEY": "dune_api_key"}
    }
  }
}

Notes on outputs and usage

All tool outputs are returned as tabulated strings to facilitate quick reading and integration into dashboards or reports.

Available tools

get_total_wallets

Retrieves the total number of wallets on Pumpfun and Pumpswap. Returns an integer indicating the total wallet count, or 0 on error.

get_alpha_wallets

Fetches the top profitable wallets for the last 30 days, including rank, wallet address, realized profit in USD, and last transaction timestamp. Optional limit parameter controls how many wallets are returned.

get_trading_wallets

Retrieves the top wallets by all-time trading volume, including rank, wallet address, trade count, and total volume in USD.

get_trading_wallet_distribution

Fetches the distribution of wallets by trading volume tiers, excluding bots, returning counts per volume tier.