DexScreener Trending MCP

1# DexScreener Trending MCP
2 
3An MCP server that provides real-time trending tokens from **DexScreener** for **BSC** and **Solana** chains.
4 
5[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
6[![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)](https://nodejs.org/)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9 
10## Features
11 
12- **Tool**: `get_trending_pairs` — fetch top trending pairs
13  - Supports `chain` parameter: `bsc` (default) or `solana`
14  - Returns both **Markdown-formatted table** (nice display in chat) and **structured JSON array**
15- **Prompt**: `analyze_trending_token` — ready-to-use analysis template for any token
16 
17## Installation
18 
191. **Clone the Repository**:
20   ```bash
21   git clone https://github.com/kukapay/dexscreener-trending-mcp.git
22   cd dexscreener-trending-mcp
23   ```
24 
252. **Install Dependencies**:
26   ```bash
27   npm install
28   ```
293. **Configure MCP Client**:
30   To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):
31    ```json
32    {
33      "mcpServers": {
34        "DexScreener Trending": {
35          "command": "node",
36          "args": ["/path/to/dexscreener-trending-mcp/index.js"]
37        }
38      }
39    }   
40    ```
41   Replace `/path/to/dexscreener-trending-mcp` with your actual installation path.
42 
43## Usage
44 
45The server exposes one powerful **tool** and one **prompt template**.  
46 
47### 1. Tool: get_trending_pairs
48 
49**Purpose**: Fetch the current top trending token pairs on DexScreener.
50 
51**Supported chains**: `bsc` (default), `solana`
52 
53**Example prompts**:
54 
55- “Show me the top 10 trending tokens on BSC right now”
56- “What are the hottest Solana pairs today? Limit to 5”
57- “List top 8 trending pairs on solana with high volume”
58 
59**Typical output** (rendered as Markdown table in most clients):
60 
61```markdown
62### Top 10 Trending Pairs on BSC
63 
64| Rank | Name          | Symbol | Price (USD) | 24h Volume     | 24h Change | Liquidity      | Market Cap     | Boosts |
65|------|---------------|--------|-------------|----------------|------------|----------------|----------------|--------|
66| 1    | TokenA        | TA     | $0.01234    | $18,765,432    | +145.2%    | $2,345,678     | $12,345,678    | 85     |
67| 2    | MoonShot      | MOON   | $0.000456   | $12,980,123    | +89.7%     | $1,890,456     | $8,765,432     | 62     |
68| 3    | CatInu        | CAT    | $0.0000789  | $9,876,543     | +210.5%    | $1,234,567     | $6,543,210     | 120    |
69| ...  | ...           | ...    | ...         | ...            | ...        | ...            | ...            | ...    |
70```
71 
72(Plus a structured JSON array in the background for further processing)
73 
74## License
75 
76MIT License. See the [LICENSE](LICENSE) file for details.
77