mcp-crypto

# CoinGecko MCP Server

A Model Context Protocol (MCP) server that provides real-time cryptocurrency data from the CoinGecko API.

## Features

- **get_price**: Get current price for any cryptocurrency
- **get_market_data**: Get detailed market data including market cap, volume, etc.
- **get_historical_data**: Get historical price data with customizable time periods
- **search_coins**: Search for cryptocurrencies by name or symbol

## Installation

1. Clone the repository
2. Install dependencies:
   ```bash
   npm install
   ```

npm run build

npm run dev

npm start

npm test

{
  "symbol": "TRX",
  "vs_currency": "usd"
}

{
  "symbol": "BTC"
}

{
  "symbol": "ETH",
  "days": 7,
  "interval": "daily"
}

{
  "query": "tron"
}

{
  "mcpServers": {
    "coingecko": {
      "command": "node",
      "args": ["/path/to/coingecko-mcp-server/build/index.js"]
    }
  }
}

## Key Changes from OKX to CoinGecko

1. **API Base URL**: Changed to `https://api.coingecko.com/api/v3`
2. **Endpoints**: Using CoinGecko's endpoints:
   - `/simple/price` for basic price data
   - `/coins/markets` for detailed market data
   - `/coins/{id}/market_chart` for historical data
   - `/search` for coin search
3. **Parameters**: Adapted to CoinGecko's parameter structure
4. **Data Format**: Updated types to match CoinGecko's response format
5. **Coin Identification**: Added support for both coin_id and symbol lookup
6. **Error Handling**: Added rate limit detection (HTTP 429)

## Setup Instructions

1. **Create the project directory:**
   ```bash
   mkdir coingecko-mcp-server
   cd coingecko-mcp-server