Crypto Trader Mcp Tool For Claude Desktop

What is Crypto-Trader-MCP-ClaudeDesktop?

Crypto-Trader-MCP-ClaudeDesktop is a powerful tool designed to provide cryptocurrency market data through the CoinGecko API. Specifically tailored for Claude Desktop, this application allows users to access real-time market information, making it easier to track cryptocurrency trends and make informed trading decisions.

Features of Crypto-Trader-MCP-ClaudeDesktop

• Real-Time Data Access: Get up-to-date cryptocurrency market data directly from the CoinGecko API.
• User-Friendly Interface: Designed for ease of use, making it accessible for both novice and experienced traders.
• MCP (Model Context Protocol) Integration: Utilizes the MCP framework to enhance data handling and processing.
• Public Repository: The project is open-source, allowing users to contribute and modify the code as needed.
• Cross-Platform Compatibility: Works seamlessly on Claude Desktop, ensuring a smooth user experience across different operating systems.

How to Use Crypto-Trader-MCP-ClaudeDesktop

1. Installation: Download the repository from GitHub and follow the installation instructions provided in the README file.
2. API Key Setup: Obtain an API key from CoinGecko and configure it within the application to start fetching market data.
3. Navigating the Interface: Familiarize yourself with the user interface, where you can view various cryptocurrency metrics such as price, market cap, and trading volume.
4. Data Analysis: Utilize the data provided to analyze market trends and make informed trading decisions.
5. Community Support: Engage with the community through GitHub issues or discussions for any queries or contributions.

Frequently Asked Questions

Q: Is Crypto-Trader-MCP-ClaudeDesktop free to use?

A: Yes, it is an open-source project available for free on GitHub.

Q: Can I contribute to the project?

A: Absolutely! Contributions are welcome. You can fork the repository, make changes, and submit a pull request.

Q: What platforms does it support?

A: The application is designed for Claude Desktop but can be adapted for other platforms as well.

Q: How do I report bugs or issues?

A: You can report any bugs or issues on the GitHub repository under the 'Issues' section.

Q: Where can I find documentation?

A: Documentation is available in the repository, including setup instructions and usage guidelines.

Crypto Trader MCP Tool for Claude Desktop

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

Tutorial

For a detailed guide on setting up and using this tool, check out our Medium tutorial: Tutorial: Using Claude Desktop with Crypto Trader MCP Tool to Get Real-Time Cryptocurrency Data

Features

• Real-time cryptocurrency price data
• Detailed market information for cryptocurrencies
• Historical price charts
• Cryptocurrency search functionality
• Trending cryptocurrencies tracking
• Global market statistics

Setup

1. Ensure you have Python 3.10 or higher installed

2. Install dependencies:

pip install -r requirements.txt

Integration with Claude Desktop

1. Configure your MCP settings in Claude Desktop by adding the following to your MCP configuration:

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

2. Replace the path with the full path to your main.py file
3. Run the server using:

py -3.13 main.py

4. Keep the server running while using Claude Desktop

Available Tools

1. get_crypto_price

Get real-time cryptocurrency price information:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "price": 65423.12,
    "change_24h": 2.5,
    "volume_24h": 28345678901,
    "market_cap": 1234567890123,
    "timestamp": "2025-03-15T10:30:00"
}

2. get_crypto_market_data

Get detailed market information for a cryptocurrency:

{
    "symbol": "ETH",
    "name": "Ethereum",
    "market_cap_rank": 2,
    "current_price": 3521.48,
    "market_cap": 423456789012,
    "total_volume": 15834567890,
    "high_24h": 3580.25,
    "low_24h": 3475.62,
    "price_change_24h": 45.86,
    "price_change_percentage_24h": 1.32,
    "circulating_supply": 120283456,
    "total_supply": 120283456,
    "max_supply": null,
    "ath": 4878.26,
    "ath_date": "2021-11-10T14:24:11.849Z",
    "atl": 0.432979,
    "atl_date": "2015-10-20T00:00:00.000Z"
}

3. get_crypto_historical_data

Get historical price data for a cryptocurrency:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "days": 30,
    "prices": [
        {
            "date": "2025-02-15T00:00:00",
            "price": 62150.23
        },
        {
            "date": "2025-02-16T00:00:00",
            "price": 63421.15
        }
        // ... more data points
    ]
}

4. search_crypto

Search for cryptocurrencies:

{
    "results": [
        {
            "id": "bitcoin",
            "symbol": "BTC",
            "name": "Bitcoin"
        },
        {
            "id": "bitcoin-cash",
            "symbol": "BCH",
            "name": "Bitcoin Cash"
        }
        // ... more results
    ]
}

5. get_trending_crypto

Get trending cryptocurrencies:

{
    "trending_coins": [
        {
            "id": "pendle",
            "name": "Pendle",
            "symbol": "PENDLE",
            "market_cap_rank": 85,
            "price_btc": 0.00002356
        }
        // ... more trending coins
    ]
}

6. get_global_crypto_data

Get global cryptocurrency market data:

{
    "active_cryptocurrencies": 12875,
    "markets": 892,
    "total_market_cap_usd": 2347890123456,
    "total_volume_usd": 89723456789,
    "market_cap_percentage": {
        "BTC": 52.4,
        "ETH": 18.2
        // ... more cryptocurrencies
    },
    "updated_at": "2025-03-15T10:30:00"
}

Sample Queries

You can ask Claude Desktop questions like:

• "What's the current price of Bitcoin?"
• "Show me detailed market data for Ethereum"
• "What's the price history of Dogecoin for the last 30 days?"
• "Search for cryptocurrencies related to 'sol'"
• "Which cryptocurrencies are trending today?"
• "What's the total cryptocurrency market capitalization right now?"

Error Handling

All tools include proper error handling and will return an error message if something goes wrong:

{
    "error": "Failed to fetch price for INVALID_SYMBOL"
}

Troubleshooting

If the MCP server is not working in Claude Desktop:

1. Make sure the server is running - you should see output when you start the script
2. Verify the path in your settings is correct and absolute
3. Make sure Python 3.10+ is in your system PATH
4. Check that all dependencies are installed
5. Try restarting Claude Desktop
6. Check logs for any error messages

Rate Limits

This tool uses the free CoinGecko API which has rate limits. Please be aware that very frequent requests may be throttled by the API.

License

MIT License