Memecoin Radar MCP

Real-time radar for Solana memecoins, Pump.fun launches, and KOL trades.

GitHub License Python Version Status

Features

Trending Tokens by Source: Retrieve top-traded tokens on platforms like Telegram, Web, or Mobile over the last 12 hours.
Pump.fun Graduates: Track tokens launched on Pump.fun, sorted by market capitalization or trading volume, and view recent graduates.
KOL Activity: Monitor recent buys and trending tokens by memecoin influencers (KOLs).
Raydium & PumpSwap Trends: Analyze tokens with the highest trading volume on Raydium and PumpSwap over customizable time spans (5h, 12h, 24h).
Customizable Limits: Configure the number of results returned for each query (default: 100).
Formatted Output: Results are presented in clean, tabular format using the tabulate library.

Prerequisites

Python 3.10 or higher
uv (recommended package manager)
A Dune Analytics API key (obtainable from Dune Analytics)

Installation

Clone the Repository

git clone https://github.com/kukapay/memecoin-radar-mcp.git
cd memecoin-radar-mcp

Install Dependencies
```
uv sync  
```

Installing to Claude Desktop:

Install the server as a Claude Desktop application:

uv run mcp install main.py --name "Memcoin Radar"

Configuration file as a reference:

{
   "mcpServers": {
       "Memecoin Radar": {
           "command": "uv",
           "args": [ "--directory", "/path/to/memecoin-radar-mcp", "run", "main.py" ],
           "env": { "DUNE_API_KEY": "dune_api_key"}               
       }
   }
}

Replace /path/to/memecoin-radar-mcp with your actual installation path, and dune_api_key with your API key from Dune Analytics.

Usage

Below is a detailed description of each tool, including its purpose, a natural language prompt example, and a sample table output.

`get_trending_tokens_by_source`

Description: Retrieves the top traded tokens on a specified platform (Telegram, Web, or Mobile) over the last 12 hours. Useful for identifying trending memecoins by platform.

Parameters:

source (str): Platform to query ('Telegram', 'Web', or 'Mobile'). Default: 'Telegram'.
limit (int): Maximum number of tokens to return. Default: 100.

Example:

Prompt: "Show me the top 3 trending tokens on Telegram in the last 12 hours."
Output:

# Top 3 Trending Tokens on Telegram - Last 12 Hours

Rank  Token    Mint Address                                Volume(12h)  Total Trades
----  -------  ------------------------------------------  -----------  ------------
1     MOON     0x1234abcd5678efgh9012ijkl3456mnop7890       $10000.00            150
2     STAR     0x5678efgh9012ijkl3456mnop7890qrst1234       $7500.00             120
3     RISE     0x9abc3456mnop7890qrst1234uvwx5678yzab       $5000.00              80

`get_pumpfun_graduates_by_marketcap`

Description: Lists Pump.fun tokens with the highest market capitalization in the last 24 hours, ideal for spotting successful token launches.

Parameters:

limit (int): Maximum number of tokens to return. Default: 100.

Example:

Prompt: "List the top 3 Pump.fun tokens by market cap in the last 24 hours."
Output:

# Top 3 Pump.fun Graduates by MarketCap - Last 24 Hours

Rank  Token    Mint Address                                MarketCap    Trade Count
----  -------  ------------------------------------------  -----------  -----------
1     PUMP     0x1234abcd5678efgh9012ijkl3456mnop7890      $500000.00           200
2     BUMP     0x5678efgh9012ijkl3456mnop7890qrst1234      $400000.00           180
3     JUMP     0x9abc3456mnop7890qrst1234uvwx5678yzab      $300000.00           150

`get_pumpfun_graduates_by_trading_volume`

Description: Shows Pump.fun tokens with the highest trading volume in the last 24 hours, highlighting active trading tokens.

Parameters:

limit (int): Maximum number of tokens to return. Default: 100.

Example:

Prompt: "Show the top 3 Pump.fun tokens by trading volume in the last 24 hours."
Output:

# Top 3 Pump.fun Graduates by Trading Volume - Last 24 Hours

Rank  Token    Mint Address                                Volume(12h)  Graduation Time
----  -------  ------------------------------------------  -----------  ---------------
1     VOLT     0x1234abcd5678efgh9012ijkl3456mnop7890      $20000.00    2025-06-14 10:00
2     SPARK    0x5678efgh9012ijkl3456mnop7890qrst1234      $15000.00    2025-06-14 09:30
3     BLAZE    0x9abc3456mnop7890qrst1234uvwx5678yzab      $10000.00    2025-06-14 08:45

`get_recent_pumpfun_graduates`

Description: Displays the most recently graduated Pump.fun tokens in the last 24 hours, useful for tracking new market entries.

Parameters:

limit (int): Maximum number of tokens to return. Default: 100.

Example:

Prompt: "Get the 3 most recent Pump.fun graduates."
Output:

# Recent 3 Pump.fun Graduates - Last 24 Hours

Graduation Time      Token    Mint Address                                Market Cap   Trade Count
-------------------  -------  ------------------------------------------  ----------   -----------
2025-06-14 12:00     NEW1     0x1234abcd5678efgh9012ijkl3456mnop7890      $250000.00          100
2025-06-14 11:30     NEW2     0x5678efgh9012ijkl3456mnop7890qrst1234      $200000.00           90
2025-06-14 11:00     NEW3     0x9abc3456mnop7890qrst1234uvwx5678yzab      $150000.00           80

`get_recent_kol_buys`

Description: Tracks recent token purchases by memecoin Key Opinion Leaders (KOLs), providing insights into influencer activity.

Parameters:

limit (int): Maximum number of buy transactions to return. Default: 100.

Example:

Prompt: "Show the 3 most recent KOL buys."
Output:

# Recent 3 Buys by Memecoin KOLs

Time                 KOL       Token    Mint Address                                Amount
-------------------  --------  -------  ------------------------------------------  --------
2025-06-14 10:00     CryptoGuru  KOL1   0x1234abcd5678efgh9012ijkl3456mnop7890      $5000.00
2025-06-14 09:45     MoonKing    KOL2   0x5678efgh9012ijkl3456mnop7890qrst1234      $3000.00
2025-06-14 09:30     TokenStar   KOL3   0x9abc3456mnop7890qrst1234uvwx5678yzab      $2000.00

`get_trending_tokens_by_kol_trading_volume`

Description: Lists tokens with the highest trading volume by KOLs, highlighting influencer-driven market trends.

Parameters:

limit (int): Maximum number of tokens to return. Default: 100.

Example:

Prompt: "List the top 3 tokens by KOL trading volume."
Output:

# Top 3 Trending Tokens by KOL Trading Volume

Token    Mint Address                                Unique KOL Buys  Total Buys  Total Volume
-------  ------------------------------------------  --------------  ----------  ------------
KOL1     0x1234abcd5678efgh9012ijkl3456mnop7890                5            50     $25000.00
KOL2     0x5678efgh9012ijkl3456mnop7890qrst1234                4            40     $18000.00
KOL3     0x9abc3456mnop7890qrst1234uvwx5678yzab                3            30     $12000.00

`get_trending_tokens_on_raydium`

Description: Retrieves tokens with the highest trading volume on Raydium over a specified time span (5h, 12h, or 24h).

Parameters:

time_span (str): Time period ('5h', '12h', or '24h'). Default: '5h'.
limit (int): Maximum number of tokens to return. Default: 100.

Example:

Prompt: "Show the top 3 trending tokens on Raydium in the last 24 hours."
Output:

# Top 3 Trending Tokens on Raydium - Last 24h

Token    Mint Address                                Volume
-------  ------------------------------------------  --------
RAY1     0x1234abcd5678efgh9012ijkl3456mnop7890      $30000.00
RAY2     0x5678efgh9012ijkl3456mnop7890qrst1234      $25000.00
RAY3     0x9abc3456mnop7890qrst1234uvwx5678yzab      $20000.00

`get_trending_tokens_on_pumpswap`

Description: Retrieves tokens with the highest trading volume on PumpSwap over a specified time span (5h, 12h, or 24h).

Parameters:

time_span (str): Time period ('5h', '12h', or '24h'). Default: '5h'.
limit (int): Maximum number of tokens to return. Default: 100.

Example:

Prompt: "Get the top 3 trending tokens on PumpSwap in the last 12 hours."
Output:

# Top 3 Trending Tokens on PumpSwap - Last 12h

Mint Address                                Trading Volume
------------------------------------------  --------------
0x1234abcd5678efgh9012ijkl3456mnop7890      $15000.00
0x5678efgh9012ijkl3456mnop7890qrst1234      $12000.00
0x9abc3456mnop7890qrst1234uvwx5678yzab      $10000.00

License

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

Memecoin Radar MCP