memecoin-radar-mcp

Memecoin Radar MCP

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

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

1. Clone the Repository
   git clone https://github.com/kukapay/memecoin-radar-mcp.git cd memecoin-radar-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 "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:

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:

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:

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:

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:

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:

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:

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:

License

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