CoinMarketCap Fear & Greed Index MCP server

The CoinMarketCap Universal MCP server provides comprehensive access to CoinMarketCap's cryptocurrency data, designed for seamless integration with Cursor. With this server, you can access cryptocurrency listings, quotes, market data, and sentiment indicators directly within your Cursor environment.

Installation

Follow these steps to install and set up the CoinMarketCap MCP server:

Prerequisites

• A CoinMarketCap API key
• Node.js installed on your system

Setup Instructions

1. Clone the repository and enter the project directory:

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

2. Install dependencies:

   npm install
   

3. Configure environment variables:

   Create a .env file in the project root directory with the following content:

   CMC_API_KEY=YOUR_COINMARKETCAP_API_KEY
   CACHE_ENABLED=true
   CACHE_TTL=300
   

   Be sure to replace YOUR_COINMARKETCAP_API_KEY with your actual CoinMarketCap API key.

4. Build and run the server:

   For development:

   npm run dev
   

   For production:

   npm run build
   npm start
   

5. Integrate with Cursor:

   • Open Cursor
   • Navigate to Settings > MCP
   • Add a new server with:
     • Type: COMMAND
     • Command: node ABSOLUTE_PATH/dist/index.js
     • Replace ABSOLUTE_PATH with the full path to your project

Available Tools

The MCP server provides access to various cryptocurrency data endpoints:

Cryptocurrency Data

• get_cryptocurrency_listings - Latest cryptocurrency listings
• get_cryptocurrency_quotes - Quotes for specific cryptocurrencies
• get_cryptocurrency_info - Cryptocurrency metadata
• get_cryptocurrency_market_pairs - Market pairs for cryptocurrencies
• get_cryptocurrency_ohlcv - Historical OHLCV data
• convert_cryptocurrency - Currency conversion functions

Exchange Data

• get_exchange_listings - Latest exchange listings
• get_exchange_info - Detailed exchange information
• get_exchange_map - Map of all exchanges

Market Data

• get_global_metrics - Global cryptocurrency market metrics
• get_fear_greed_index - Fear & Greed Index data

Usage Examples

Get Latest Cryptocurrency Listings

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

Get Cryptocurrency Quotes

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

Get the Fear & Greed Index

get_fear_greed_index({
  limit: 7
})

Get Global Market Metrics

get_global_metrics({
  convert: "USD"
})

Troubleshooting

If you encounter issues with the MCP server:

• Verify you have a valid CoinMarketCap API key
• Ensure the .env file contains the correct configuration
• Check the console logs for detailed error information
• Confirm your API plan has access to the endpoints you're using

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "coinmarketcap-fear-greed-index" '{"command":"node","args":["ABSOLUTE PATH/dist/index.js"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "coinmarketcap-fear-greed-index": {
            "command": "node",
            "args": [
                "ABSOLUTE PATH/dist/index.js"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "coinmarketcap-fear-greed-index": {
            "command": "node",
            "args": [
                "ABSOLUTE PATH/dist/index.js"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect