memecoin-radar-mcp
by kukapay
README.md
# 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](https://github.com/astral-sh/uv) (recommended package manager)
- A Dune Analytics API key (obtainable from [Dune Analytics](https://dune.com))
## Installation
1. **Clone the Repository**
```bash
git clone https://github.com/kukapay/memecoin-radar-mcp.git
cd memecoin-radar-mcp
```
2. **Install Dependencies**
```bash
uv sync
```
3. **Installing to Claude Desktop**:
Install the server as a Claude Desktop application:
```bash
uv run mcp install main.py --name "Memcoin Radar"
```
Configuration file as a reference:
```json
{
"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](LICENSE) file for details.
TDQS
A4.1/5.0
Scored across 8 tools
Disambiguation3/5
The tools have clear distinctions in their primary focus (Pump.fun graduates, KOL activity, trending tokens by source/platform), but there is some overlap in purpose. For example, get_pumpfun_graduates_by_marketcap and get_pumpfun_graduates_by_trading_volume both retrieve Pump.fun graduates with different sorting criteria, which could cause confusion if an agent needs general graduate data without a specific sorting preference. The descriptions help clarify, but the boundaries between tools like get_trending_tokens_by_kol_trading_volume and get_recent_kol_buys are somewhat fuzzy, as both relate to KOL activity.
Naming Consistency5/5
All tool names follow a consistent verb_noun pattern with 'get_' prefix, using snake_case throughout. The naming is predictable and clear, such as get_pumpfun_graduates_by_marketcap and get_trending_tokens_on_raydium, making it easy for agents to understand the action and target resource without confusion.
Tool Count4/5
With 8 tools, the count is reasonable for a memecoin tracking server, covering multiple aspects like graduates, KOL activity, and trending tokens across platforms. It's slightly on the higher side but well-scoped, as each tool serves a distinct query type. However, it might feel a bit heavy for a narrow domain, but not excessively so.
Completeness3/5
The tool set provides good coverage for retrieving data on memecoin trends, graduates, and KOL activity, but there are notable gaps. It lacks tools for creating, updating, or deleting data (e.g., no way to add custom alerts or track specific tokens), which limits it to read-only operations. While this might be intentional for a radar server, the surface feels incomplete for full lifecycle management or interactive features beyond basic queries.
Maintenance
ActivityInactive
ResponsivenessNo issues