home / mcp / crypto fear & greed index mcp server

Crypto Fear & Greed Index MCP Server

Providing real-time and historical Crypto Fear & Greed Index data

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kukapay-crypto-feargreed-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/your/path/to/crypto-feargreed-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

This Crypto Fear & Greed Index MCP Server provides real-time and historical insights into market sentiment derived from the Crypto Fear & Greed Index. It exposes a simple MCP interface you can query from Claude Desktop and other MCP clients to fetch current values, review historical data, analyze trends, and interpret what the numbers may imply for cryptocurrency markets.

How to use

You connect to this MCP server from an MCP client to access the Fear & Greed Index data. You can retrieve the latest index value, view historical data for a chosen number of days, and run trend analyses to understand how sentiment is shifting over time.

Use the available tools to fetch data and generate interpretations. The server includes a current index tool, a historical data tool, a trend analysis tool, and a prompt for interpreting the index values.

Example workflows you can perform: retrieve the current value, fetch 30 days of history, and analyze the trend over that period to determine whether sentiment is rising or falling. Then generate a plain-language interpretation for your crypto decisions.

How to install

Prerequisites you need before installation include a Python runtime and a compatible MCP client setup. If you are integrating with Claude Desktop, you will also use the MCP installation flow described here.

Clone the MCP server repository, install dependencies if prompted, and prepare the runtime entry point as described in the steps below.

Clone the repository and prepare the runtime for Claude Desktop or other MCP clients.

1) Clone the repository.

git clone https://github.com/kukapay/crypto-feargreed-mcp.git
cd crypto-feargreed-mcp

Configuration and runtime entry

To run the MCP server locally, you will use a stdio-based runtime configuration. The following example shows a complete MCP server entry you can place in your configuration file under mcpServers.

{
  "mcpServers": {
    "crypto_feargreed_mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory", "/your/path/to/crypto-feargreed-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Enable and run

After you add the MCP server entry, enable it in your MCP client configuration. Start the server using the runtime command portion shown in the configuration example above. The server will expose resources for current data, historical data, and trend analysis through the MCP interface.

Notes and examples

Examples of common prompts you can use with the MCP server include asking for the current Fear & Greed Index, requesting a 30-day trend, and requesting an interpretation for a given index value.

Prompts you can use directly include: interpret_fng for guiding interpretation of a specific index value and prompts to fetch current and historical data via the provided tools.

Available tools

get_current_fng_tool

Returns the current Crypto Fear & Greed Index value and its classification, allowing clients to fetch the latest index quickly.

get_historical_fng_tool

Returns historical Fear & Greed Index data for a specified number of days, enabling time-based analysis.

analyze_fng_trend

Analyzes the trend over a given period and returns statistics such as latest value, average, and direction of change.

interpret_fng

Prompts to interpret the Fear & Greed Index value and explain its implications for cryptocurrency markets, including Bitcoin.