Content
# DexScreener Trending MCP
An MCP server that provides real-time trending tokens from **DexScreener** for **BSC** and **Solana** chains.
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
## Features
- **Tool**: `get_trending_pairs` — fetch top trending pairs
- Supports `chain` parameter: `bsc` (default) or `solana`
- Returns both **Markdown-formatted table** (nice display in chat) and **structured JSON array**
- **Prompt**: `analyze_trending_token` — ready-to-use analysis template for any token
## Installation
1. **Clone the Repository**:
```bash
git clone https://github.com/kukapay/dexscreener-trending-mcp.git
cd dexscreener-trending-mcp
```
2. **Install Dependencies**:
```bash
npm install
```
3. **Configure MCP Client**:
To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):
```json
{
"mcpServers": {
"DexScreener Trending": {
"command": "node",
"args": ["/path/to/dexscreener-trending-mcp/index.js"]
}
}
}
```
Replace `/path/to/dexscreener-trending-mcp` with your actual installation path.
## Usage
The server exposes one powerful **tool** and one **prompt template**.
### 1. Tool: get_trending_pairs
**Purpose**: Fetch the current top trending token pairs on DexScreener.
**Supported chains**: `bsc` (default), `solana`
**Example prompts**:
- “Show me the top 10 trending tokens on BSC right now”
- “What are the hottest Solana pairs today? Limit to 5”
- “List top 8 trending pairs on solana with high volume”
**Typical output** (rendered as Markdown table in most clients):
```markdown
### Top 10 Trending Pairs on BSC
| Rank | Name | Symbol | Price (USD) | 24h Volume | 24h Change | Liquidity | Market Cap | Boosts |
|------|---------------|--------|-------------|----------------|------------|----------------|----------------|--------|
| 1 | TokenA | TA | $0.01234 | $18,765,432 | +145.2% | $2,345,678 | $12,345,678 | 85 |
| 2 | MoonShot | MOON | $0.000456 | $12,980,123 | +89.7% | $1,890,456 | $8,765,432 | 62 |
| 3 | CatInu | CAT | $0.0000789 | $9,876,543 | +210.5% | $1,234,567 | $6,543,210 | 120 |
| ... | ... | ... | ... | ... | ... | ... | ... | ... |
```
(Plus a structured JSON array in the background for further processing)
## License
MIT License. See the [LICENSE](LICENSE) file for details.
