Skip to main content
Glama
kukapay

crypto-trending-mcp

by kukapay

Crypto Trending MCP Server

An MCP server that tracks and monitors the latest trending tokens on CoinGecko, providing real-time insights into the most popular cryptocurrencies.

Discord GitHub License Python Version Status

Features

  • Tool: get_trending_md_doc
    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.

  • Prompt: parse_trending_md_doc
    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.

  • Seamless Integration
    Designed for use with Claude Desktop, allowing natural language queries to analyze trending crypto data via MCP tools and prompts.

  • Lightweight & Extensible
    Built with minimal dependencies and a simple architecture, making it easy to extend or deploy.

Related MCP server: hf-trending-mcp

Installation

Prerequisites

  • Python 3.10+

  • Node.js (for Playwright browser dependencies)

  • Claude Desktop (optional, for testing with MCP client)

Steps

  1. Clone the Repository:

    git clone https://github.com/kukapay/crypto-trending-mcp.git
    cd crypto-trending-mcp
  2. Install Dependencies with uv:

    uv sync
    playwright install

Usage

Integrating with Claude Desktop

  1. Configure Claude Desktop:

    • Edit the configuration file:

      • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

      • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • Add the server configuration:

      {
        "mcpServers": {
          "crypto-trending": {
            "command": "uv",
            "args": [
              "--directory",
              "/absolute/path/to/crypto-trending-mcp",
              "run",
              "main.py"
            ]
          }
        }
      }

      Replace /absolute/path/to/crypto-trending-mcp with the absolute path to your main.py.

  2. Restart Claude Desktop:

    • Close and reopen Claude Desktop.

    • Look for the hammer icon (šŸ”Ø) in the input box, indicating MCP tools are available.

  3. Interact with the Server:

    • Ask natural language questions like:

      • "What are the trending cryptocurrencies with positive 24h price changes?"

      • "Show the top 3 trending coins by market cap."

    • Claude will use the get_trending_md_doc tool and parse_trending_md_doc prompt to fetch and analyze the data.

Example Output

The get_trending_md_doc tool returns a Markdown document like:

# Trending Crypto

...

| Rank | Name        | Symbol | Price      | 1h Change | 24h Change | 7d Change | 24h Volume      | Market Cap         |
|------|-------------|--------|------------|-----------|------------|-----------|-----------------|-------------------|
| 1    | Bitcoin     | BTC    | $67,890.12 | +0.45%    | +2.34%     | +10.12%   | $45,123,456,789 | $1,345,678,901,234 |
| 2    | Ethereum    | ETH    | $2,456.78  | -0.12%    | -1.12%     | +5.67%    | $20,987,654,321 | $295,123,456,789   |
| 3    | Solana      | SOL    | $167.45    | +0.89%    | +5.67%     | +15.34%   | $3,456,789,123  | $78,901,234,567    |

...

*Data from CoinGecko*

The parse_trending_md_doc prompt guides the LLM to extract the table and produce structured output, such as:

[
  {
    "rank": 1,
    "name": "Bitcoin",
    "symbol": "BTC",
    "price": "$67,890.12",
    "change_1h": "+0.45%",
    "change_24h": "+2.34%",
    "change_7d": "+10.12%",
    "volume_24h": "$45,123,456,789",
    "market_cap": "$1,345,678,901,234"
  },
  ...
]

License

This project is licensed under the MIT License. See the LICENSE file for details.

Available Tools

1 tool

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool update
    • First observedget_trending_md_doc

TDQS

A3.9/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is clearly defined and distinct by default.

Naming Consistency5/5

A single tool inherently has consistent naming, as there are no other tools to compare against. The name 'get_trending_md_doc' follows a clear verb_noun pattern.

Tool Count2/5

One tool is too few for a server named 'crypto-trending-mcp', which suggests a broader scope for cryptocurrency trending data. A single tool limits functionality and makes the server feel incomplete or trivial for its apparent purpose.

Completeness2/5

The server is severely incomplete for a cryptocurrency trending domain. It only retrieves a Markdown document from CoinGecko, lacking tools for filtering, sorting, analyzing trends, or accessing other trending sources, which are essential for comprehensive coverage.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

  • Crypto market intelligence, token rug-checks, and wallet verification in one MCP server.

  • Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.

  • Official CoinMarketCap MCP server: real-time crypto prices, market cap, rankings and exchange data.

  • Your agent needs crypto prices it can rely on — spot, ranked market tables, history, OHLC, per-venue tickers, and what is trending right now. **What you can ask for** • "What is the price of these 20 tokens in USD and EUR right now?" • "Give me the top 100 by market cap with 24h and 7d change." • "Chart this coin's price over the last year, hourly." • "Where does this token trade, and at what spread per venue?" • "What is trending on CoinGecko today?" **How to use it** Point any MCP client at https://mcp.aisa.one/crypto-market-data/mcp and sign in with OAuth — there is no key to create or paste. 21 CoinGecko tools: simple price and token price by contract, supported currencies, coin list and detail, ranked markets, history, market charts and ranges, OHLC, per-coin tickers, categories, exchanges and their tickers, token data and charts, and trending. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Price the token here, then ask the same agent what X is posting about it — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.

Related MCP Servers