home / mcp / crypto trader mcp server

Crypto Trader MCP Server

An MCP (Model Context Protocol) tool that provides cryptocurrency market data using the CoinGecko API, specifically designed for Claude Desktop.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "saintdoresh-crypto-trader-mcp-claudedesktop": {
      "command": "py",
      "args": [
        "-3.13",
        "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"
      ]
    }
  }
}

You can run the Crypto Trader MCP Tool for Claude Desktop to fetch real-time cryptocurrency data from CoinGecko and deliver detailed market insights directly to Claude Desktop. This MCP server makes it easy to query prices, market data, historical prices, searches, trending coins, and global market stats in a consistent, programmatic way.

How to use

You connect to the MCP server from your MCP client (Claude Desktop) and send requests for specific crypto data. Use the endpoints provided by the server to get current prices, market details, historical data, search results, trending coins, and global market metrics. You can combine queries to build dashboards, alerts, or quick answers to market questions.

How to install

Prerequisites you need on your system before running the MCP server:

- Python 3.10 or higher is installed and available in your system PATH.

- The project dependencies can be installed with pip.

Setup and run (stdio MCP server)

{
  "mcpServers": {
    "crypto-trader": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
    }
  }
}

Operate the MCP server locally

Start the MCP server using the runtime command shown in your setup snippet. Keep the server running while you use Claude Desktop so it can respond to your data queries.

If you need to run directly from a shell, you can use the equivalent command shown in the integration snippet:

Troubleshooting

If the MCP server isn’t responding in Claude Desktop, check the following steps to resolve common issues:

- Ensure the server process is running and not terminated after startup. You should see output indicating initialization when starting the script.

- Confirm the configured path to main.py is correct and uses an absolute path.

- Verify Python 3.10+ is installed and accessible from your system PATH.

- Confirm all required dependencies are installed by running the provided dependency installation step.

- Review application logs for any error messages and address them accordingly.

Notes on usage and capabilities

This MCP tool exposes a range of data endpoints powered by CoinGecko, including real-time prices, market data, historical price data, search functionality, trending coins, and global market statistics.

Available tools

get_crypto_price

Fetch real-time price information for a specified cryptocurrency symbol or name, including price, 24h change, 24h volume, market cap, and timestamp.

get_crypto_market_data

Retrieve detailed market information for a specific cryptocurrency, including current price, market cap, total volume, highs/lows, price changes, supply data, and all-time highs/lows.

get_crypto_historical_data

Obtain historical price data for a cryptocurrency over a specified number of days, returning a list of date-price data points.

search_crypto

Search for cryptocurrencies by keyword and return matching results with id, symbol, and name.

get_trending_crypto

Get a list of currently trending cryptocurrencies with basic identifiers and market rankings.

get_global_crypto_data

Provide global market data such as total market cap, total volume, active cryptocurrencies, market counts, and last update timestamp.