Crypto Feargreed MCP

What kukapay/crypto-feargreed-mcp MCP server does

The kukapay/crypto-feargreed-mcp MCP server gives an MCP-compatible client access to Crypto Fear & Greed Index information. It can return the latest index value with its classification, retrieve a selected number of historical observations, and summarize movement across a period.

The data is provided through the Alternative.me Fear & Greed Index API. Results include timestamps, numeric index values, and labels such as Fear. The project is implemented for Python 3.10 or newer and is licensed under MIT.

How it works

The server exposes two resources:

• fng://current returns the latest index value and classification.
• fng://history/{days} returns historical entries for the requested number of days.

It also includes tool equivalents for clients that do not support MCP resources. get_current_fng_tool() mirrors the current-value resource, while get_historical_fng_tool(days: int) retrieves historical data for the supplied period.

For analysis, analyze_fng_trend(days: int) examines the requested number of data points and reports the latest value, average value, trend direction, and number of observations analyzed. The interpret_fng prompt provides a template that asks an MCP client to explain an index value in the context of cryptocurrency markets, specifically Bitcoin.

Setup and configuration

The repository can be cloned locally and run from its main.py entry point. The README documents installation for Claude Desktop with the MCP installation command and shows a configuration using uv to run the local project directory. The directory in that example must be replaced with the path where the repository was cloned.

Smithery installation is also documented for Claude Desktop. The README identifies Claude Desktop as a supported MCP client and states that the server can be added to other clients through their MCP server configuration.

No environment variables or credential settings are documented in the supplied material. The server obtains its index data from Alternative.me, and the README does not describe an API key configuration.

Tools and capabilities

The kukapay/crypto-feargreed-mcp MCP server supports these primary operations:

• Read the latest Fear & Greed Index value and classification.
• Request historical index values for a specified number of days.
• Calculate an average and identify whether the index trend is rising or falling over a period.
• Use tool-only equivalents of the resource operations.
• Generate an interpretation prompt for a returned index value.

These capabilities support questions such as asking for the current market sentiment or requesting a 30-day trend view from an MCP client.

Limitations and notes

The supplied documentation describes index retrieval and basic trend statistics, not trading execution, portfolio management, price data, or broader market indicators. Trend analysis is based on the selected index observations and reports simple statistics; the README does not describe configurable analytical methods.

The project depends on the availability of the Alternative.me Fear & Greed Index API. Historical requests require a day count, and the documentation does not specify validation behavior for invalid, zero, or unusually large values. The interpretation feature generates a prompt for the client rather than documenting a separate forecasting or recommendation engine.