Crypto Trending MCP Server

1# Crypto Trending MCP Server
2 
3An MCP server that tracks and monitors the latest trending tokens on CoinGecko, providing real-time insights into the most popular cryptocurrencies.
4 
5<a href="https://glama.ai/mcp/servers/@kukapay/crypto-trending-mcp">
6  <img width="380" height="200" src="https://glama.ai/mcp/servers/@kukapay/crypto-trending-mcp/badge" alt="crypto-trending-mcp MCP server" />
7</a>
8 
9[![Discord](https://img.shields.io/discord/1353556181251133481?cacheSeconds=3600)](https://discord.gg/aRnuu2eJ)
10![GitHub License](https://img.shields.io/github/license/kukapay/crypto-trending-mcp)
11![Python Version](https://img.shields.io/badge/python-3.10+-blue)
12![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
13 
14## Features
15 
16- **Tool: `get_trending_md_doc`**  
17  Returns a Markdown document of the full CoinGecko trending page, including a table of trending cryptocurrencies with columns: Rank, Name, Symbol, Price, 1h Change, 24h Change, 7d Change, 24h Volume, Market Cap.
18 
19- **Prompt: `parse_trending_md_doc`**  
20  Guides MCP clients to extract the trending coins table from the Markdown document and parse it with an LLM, supporting analyses like identifying coins with positive price changes or ranking by market cap.
21 
22- **Seamless Integration**  
23  Designed for use with Claude Desktop, allowing natural language queries to analyze trending crypto data via MCP tools and prompts.
24 
25- **Lightweight & Extensible**  
26  Built with minimal dependencies and a simple architecture, making it easy to extend or deploy.
27 
28## Installation
29 
30### Prerequisites
31 
32- **Python 3.10+**
33- **Node.js** (for Playwright browser dependencies)
34- **Claude Desktop** (optional, for testing with MCP client)
35 
36### Steps
37 
381. **Clone the Repository**:
39 
40   ```bash
41   git clone https://github.com/kukapay/crypto-trending-mcp.git
42   cd crypto-trending-mcp
43   ```
44 
452. **Install Dependencies with uv**:
46 
47   ```bash
48   uv sync
49   playwright install
50   ```
51 
52## Usage
53 
54### Integrating with Claude Desktop
55 
561. **Configure Claude Desktop**:
57 
58   - Edit the configuration file:
59     - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
60     - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
61   - Add the server configuration:
62 
63     ```json
64     {
65       "mcpServers": {
66         "crypto-trending": {
67           "command": "uv",
68           "args": [
69             "--directory",
70             "/absolute/path/to/crypto-trending-mcp",
71             "run",
72             "main.py"
73           ]
74         }
75       }
76     }
77     ```
78 
79     Replace `/absolute/path/to/crypto-trending-mcp` with the absolute path to your `main.py`.
80 
812. **Restart Claude Desktop**:
82 
83   - Close and reopen Claude Desktop.
84   - Look for the hammer icon (🔨) in the input box, indicating MCP tools are available.
85 
863. **Interact with the Server**:
87 
88   - Ask natural language questions like:
89     - "What are the trending cryptocurrencies with positive 24h price changes?"
90     - "Show the top 3 trending coins by market cap."
91   - Claude will use the `get_trending_md_doc` tool and `parse_trending_md_doc` prompt to fetch and analyze the data.
92 
93### Example Output
94 
95The `get_trending_md_doc` tool returns a Markdown document like:
96 
97```markdown
98# Trending Crypto
99 
100...
101 
102| Rank | Name        | Symbol | Price      | 1h Change | 24h Change | 7d Change | 24h Volume      | Market Cap         |
103|------|-------------|--------|------------|-----------|------------|-----------|-----------------|-------------------|
104| 1    | Bitcoin     | BTC    | $67,890.12 | +0.45%    | +2.34%     | +10.12%   | $45,123,456,789 | $1,345,678,901,234 |
105| 2    | Ethereum    | ETH    | $2,456.78  | -0.12%    | -1.12%     | +5.67%    | $20,987,654,321 | $295,123,456,789   |
106| 3    | Solana      | SOL    | $167.45    | +0.89%    | +5.67%     | +15.34%   | $3,456,789,123  | $78,901,234,567    |
107 
108...
109 
110*Data from CoinGecko*
111```
112 
113The `parse_trending_md_doc` prompt guides the LLM to extract the table and produce structured output, such as:
114 
115```json
116[
117  {
118    "rank": 1,
119    "name": "Bitcoin",
120    "symbol": "BTC",
121    "price": "$67,890.12",
122    "change_1h": "+0.45%",
123    "change_24h": "+2.34%",
124    "change_7d": "+10.12%",
125    "volume_24h": "$45,123,456,789",
126    "market_cap": "$1,345,678,901,234"
127  },
128  ...
129]
130```
131 
132## License
133 
134This project is licensed under the MIT License. See the LICENSE file for details.