crypto-feargreed-mcp

# Crypto Fear & Greed Index MCP Server A mcp server that provides real-time and historical Crypto Fear & Greed Index data, powered by the Alternative.me. This server exposes resources and tools for fetching and analyzing the Fear & Greed Index, making it easy to integrate into MCP-compatible clients, including Claude Desktop.    ## Features - **Current Index**: Retrieve the latest Fear & Greed Index value and classification. - **Historical Data**: Fetch historical index values for a specified number of days. - **Trend Analysis**: Analyze trends over time with statistics like average value and trend direction. - **Tool-Only Support**: Includes tool versions of all resources for compatibility with tool-only MCP clients. - **Prompt Generation**: Provides a prompt template for interpreting index values. ### Resources - `fng://current`. Current crypto Fear & 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 Crypto Fear & 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 Value: 47.3 Trend: falling Data points analyzed: 30 ``` ### Prompts - `interpret_fng` Index Data Interpretation. Output: ``` Please interpret this Crypto Fear & Greed Index value and explain what it means for cryptocurrency markets (specifically Bitcoin): 45 ``` ## Installation Clone the repository: ```bash 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 a server entry to your configuration file: ``` "mcpServers": { "crypto-feargreed-mcp": { "command": "uv", "args": [ "--directory", "/your/path/to/crypto-feargreed-mcp", "run", "main.py" ] } } ``` ## Examples After installation, ask: - "What's the current Crypto Fear & Greed Index?" - "Show me the Crypto Fear & Greed Index trend for the last 30 days." Claude will automatically call the appropriate tools and provide responses. ## License This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. ## Acknowledgments - Built with [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk). - Data provided by [Alternative.me Fear & Greed Index API](https://api.alternative.me/fng/).