Crypto Feargreed MCP

🚀 Crypto Fear & Greed Index MCP Server

A MCP server providing real - time and historical data on the cryptocurrency fear and greed index, powered by Alternative.me.

This server exposes data resources and tools for retrieving and analyzing the fear and greed index, making it easy to integrate into compatible MCP clients, including Claude Desktop.

✨ Features

• Current Index: Retrieve the latest fear and greed index value and classification.
• Historical Data: Obtain historical index values for a specified number of days.
• Trend Analysis: Analyze trends over a period, including average values and trend direction statistics.
• Tool - Specific Support: A tool version containing all resources to be compatible with tool - specific MCP clients.
• Prompt Generation: Provide prompt templates to explain index values.

Resources

• fng://current. Current cryptocurrency fear and greed index. Output:

Crypto Fear & Greed Index (as of 2025 - 03 - 15 00:00:00 UTC):
Value: 45
Classification: Fear

• fng://history/{days}. Historical data of the cryptocurrency fear and greed index. Output:

Historical Crypto Fear & Greed Index:
2025 - 03 - 15 00:00:00 UTC: 45 (Fear)
2025 - 03 - 14 00:00:00 UTC: 48 (Fear)
...

Tools

• get_current_fng_tool() -> str. Current index. Same as fng://current.

• get_historical_fng_tool(days: int) -> str. Historical index data. Same as fng://history/{days}.

• analyze_fng_trend(days: int) -> str. Index trend analysis. Output:

Fear & Greed Index Analysis (30 days):
Latest Value: 45 (Fear) at 2025 - 03 - 15 00:00:00 UTC
Average: 47.3
Trend: Downward
Data Points Analyzed: 30

Prompts

• interpret_fng Index data interpretation. Output:

Please explain the meaning of this Crypto Fear & Greed Index value and its implications for the cryptocurrency market (especially Bitcoin): 45

📦 Installation

Clone the repository:

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

Install for Claude Desktop:

mcp install main.py --name "CryptoFearGreed"

Then enable it in your Claude Desktop configuration.

For other clients, add the server entry to the configuration file:

"mcpServers": { 
  "crypto-fear-greed-mcp": {
    "url": "http://localhost:5000",
    "user": "",
    "password": ""
  }
}

💻 Usage Examples

Possible user queries:

• "What is the Fear & Greed Index of the cryptocurrency market?"
• "What is the trend of the Fear & Greed Index in the past week?"

Claude's response will be based on the current index and historical data analysis and provide corresponding explanations.

📄 License

[Project license information]

Acknowledgments

Thanks to the following individuals and projects for their contributions:

• [List contributors]
• [Cite relevant resources or tools]

This server aims to help users better understand the fluctuating sentiment in the cryptocurrency market by providing real - time insights through the Fear & Greed Index.