The crypto-feargreed-mcp is an MCP server providing real-time and historical Crypto Fear & Greed Index data, sourced from Alternative.me. It empowers AI models to understand market sentiment, enhancing their analytical and predictive capabilities within the cryptocurrency domain.

This solution offers resources like fng://current for the latest index and fng://history/{days} for historical data. It also includes tool versions for compatibility with tool-only MCP clients and a prompt template for interpreting index values. Developers can seamlessly integrate this server into MCP-compatible clients, such as Claude Desktop, to enable AI models to access and interpret market sentiment data directly. The core value lies in providing AI with timely, quantified insights into market psychology, enabling more informed decision-making. Installation is straightforward, involving cloning the repository and either using the mcp install command for Claude Desktop or adding a server entry to the client's configuration file.

Real-time Fear & Greed Index

The crypto-feargreed-mcp server provides access to the current Crypto Fear & Greed Index, offering an immediate snapshot of market sentiment. This index, sourced from Alternative.me, ranges from 0 to 100 and is categorized into levels like "Extreme Fear," "Fear," "Neutral," "Greed," and "Extreme Greed." The server delivers this data through the fng://current resource and the get_current_fng_tool() tool. This allows AI models to understand the prevailing emotional state of the cryptocurrency market, which is crucial for tasks like predicting price movements or assessing investment risk. For example, an AI-powered trading bot could use this information to reduce buying activity during periods of "Extreme Greed," anticipating a potential market correction. The real-time nature of the data ensures that AI models are always working with the most up-to-date market sentiment.

Historical Data Retrieval

This feature allows AI models to access historical Crypto Fear & Greed Index values for a specified number of days. By using the fng://history/{days} resource or the get_historical_fng_tool(days: int) tool, users can retrieve a time series of index values. This historical perspective is invaluable for training AI models to recognize patterns and correlations between market sentiment and other variables, such as trading volume or news events. For instance, a data scientist could use this historical data to build a model that predicts future index values based on past trends. The ability to specify the number of days allows for flexible analysis, from short-term trends to long-term cycles. The data is formatted for easy parsing and integration into various analytical tools.

Trend Analysis Tool

The analyze_fng_trend(days: int) tool provides a statistical analysis of the Fear & Greed Index over a specified period. This includes the latest index value, the average value over the period, and the overall trend direction (e.g., rising, falling, or stable). This tool simplifies the process of identifying and quantifying trends in market sentiment, saving developers time and effort. An AI model could use this trend analysis to refine its trading strategies or to generate more nuanced market reports. For example, if the trend is "falling" and the average value is high, it might indicate a market that is becoming increasingly fearful after a period of greed, potentially signaling a sell-off. The tool provides a concise summary of the data, making it easy to incorporate into automated decision-making processes.

Prompt Generation for Interpretation

The interpret_fng prompt provides a pre-formatted prompt template designed to guide AI models in interpreting the Crypto Fear & Greed Index value. This feature is particularly useful for AI models that need to provide human-readable explanations of market sentiment. The prompt encourages the AI to explain the meaning of the index value and its implications for the cryptocurrency market, specifically Bitcoin. This can be used in applications such as automated news generation or educational tools. For example, an AI could use the prompt to generate a headline like "Fear Grips Bitcoin Market as Fear & Greed Index Falls to 30, Suggesting Potential Buying Opportunity." This feature streamlines the process of integrating the Fear & Greed Index into AI-driven content creation workflows.

Tool-Only Compatibility

The crypto-feargreed-mcp server includes tool versions of all resources, ensuring compatibility with MCP clients that only support tools. This is a crucial feature for maximizing the accessibility of the Fear & Greed Index data across the MCP ecosystem. By providing both resource and tool interfaces, the server caters to a wider range of AI models and applications. For example, an AI model running on a resource-constrained device might only be able to interact with tools, making this compatibility essential. This design choice reflects a commitment to inclusivity and interoperability within the MCP ecosystem, ensuring that all clients can benefit from the insights provided by the Fear & Greed Index.