# DexScreener Trending MCP

An MCP server that provides real-time trending tokens from **DexScreener** for **BSC** and **Solana** chains.

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)](https://nodejs.org/)
![Status](https://img.shields.io/badge/status-active-brightgreen.svg)


## 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.