Skip to main content
Glama

pumpfun-wallets-mcp

Pumpfun Wallets MCP

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

GitHub License Python Version Status

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

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:
How many wallets are there on Pumpfun and Pumpswap?

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:
Show me the top 5 most profitable wallets on Pumpfun and Pumpswap for the last 30 days.

Output:

Rank Wallet Realized Profit Last Tx ---- ------------------------------------------ --------------- -------------------- 1 0x123...abc $50000 2025-06-10 12:34:56 2 0x456...def $45000 2025-06-09 09:12:34 ...

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:
Who are the top 3 wallets with the highest trading volume on Pumpfun and Pumpswap?

Output:

Rank Wallet Trade Count Total Volume ---- ------------------------------------------ ----------- ------------ 1 0x789...ghi 1500 $1000000 2 0xabc...jkl 1200 $950000 3 0xdef...mno 1000 $800000

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:
What is the distribution of wallets by trading volume on Pumpfun and Pumpswap, excluding bots?

Output:

Volume Tier Number of Wallets --------------- ----------------- $0 - $1000 5000 $1000 - $10000 2000 $10000+ 500

License

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

  1. Features
    1. Prerequisites
      1. Installation
        1. Tools
          1. get_total_wallets()
          2. get_alpha_wallets(limit: int = 100)
          3. get_trading_wallets(limit: int = 10)
          4. get_trading_wallet_distribution()
        2. License

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            An MCP server that tracks newly created liquidity pools on Uniswap across nine blockchain networks.
            Last updated -
            5
            Python
            MIT License
          • -
            security
            A
            license
            -
            quality
            An MCP server providing a range of cryptocurrency technical analysis indicators and strategies.
            Last updated -
            1
            58
            JavaScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            MCP Server for the CoinStats API. Provides access to cryptocurrency market data, portfolio tracking, and news.
            Last updated -
            30
            579
            5
            TypeScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            An MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.
            Last updated -
            17
            40
            Python
            MIT License
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/kukapay/pumpfun-wallets-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server