Coinmarketcap Fear & Greed Index

🚀 CoinMarketCap Unified MCP Server

This project is a Model Context Protocol (MCP) server that provides comprehensive access to CoinMarketCap cryptocurrency data. It is designed for easy integration into Cursor, enabling direct access to a wide range of cryptocurrency data within the Cursor environment.

🚀 Quick Start

This project aims to seamlessly integrate with Cursor's MCP feature. Here's how to add it:

1. Clone the repository and navigate to the project directory:

   git clone https://github.com/yourusername/coinmarketcap-mcp.git
   cd coinmarketcap-mcp
   

2. Install dependencies:

   npm install
   

3. Set up environment variables:

   • Create a .env file in the project root directory.

   • Add your CoinMarketCap API key:

     CMC_API_KEY=YOUR_COINMARKETCAP_API_KEY
     CACHE_ENABLED=true
     CACHE_TTL=300
     

     Replace YOUR_COINMARKETCAP_API_KEY with your actual API key.

4. Build and run the server:

   • Development environment:

     npm run dev
     

   • Production environment:

     npm run build
     npm start
     

5. Add to Cursor:

   • Open Cursor.
   • Go to Settings > MCP.
   • Add a new server with the following configuration:
     • Type: COMMAND
     • Command: node absolute_path/dist/index.js

Now, you can directly use all available tools in Cursor to access CoinMarketCap data!

✨ Features

• Comprehensive API Coverage: Access multiple CoinMarketCap API endpoints.
• Intelligent Caching: Reduce API calls and improve performance.
• Type Safety: Full TypeScript support with comprehensive type definitions.
• Modular Design: Easy to extend and maintain.
• Detailed Error Handling: Clear error messages and logs.

📦 Available Tools

Cryptocurrency Data

• get_cryptocurrency_listings - Get the latest cryptocurrency listings.
• get_cryptocurrency_quotes - Get quotes for specific cryptocurrencies.
• get_cryptocurrency_info - Get metadata for cryptocurrencies.
• get_cryptocurrency_market_pairs - Get trading pairs for cryptocurrencies.
• get_cryptocurrency_ohlcv - Get historical OHLCV data.
• convert_cryptocurrency - Convert between cryptocurrencies and fiat currencies.

Exchange Data

• get_exchange_listings - Get the latest exchange listings.
• get_exchange_info - Get detailed exchange information.
• get_exchange_map - Get a map of all exchanges.

Global Market Data

• get_global_metrics - Get global cryptocurrency market metrics.

Market Sentiment

• get_fear_greed_index - Get fear and greed index data.

💻 Usage Examples

Get the latest cryptocurrency listings

get_cryptocurrency_listings({
  limit: 10,
  convert: "USD"
})

Get quotes for specific cryptocurrencies

get_cryptocurrency_quotes({
  symbol: "BTC,ETH,SOL",
  convert: "USD"
})

Get the fear and greed index

get_fear_greed_index({
  limit: 7
})

Get global market metrics

get_global_metrics({
  convert: "USD"
})

🛠️ Troubleshooting

If you encounter issues:

1. Ensure you have a valid CoinMarketCap API key.
2. Check if the .env file is configured correctly.
3. View console logs for detailed error information.
4. Make sure your API plan allows access to the endpoints you're trying to use.

📄 License

This project is licensed under the MIT License.