Crypto Fear & Greed Index MCP Server

1# Crypto Fear & Greed Index MCP Server
2 
3A mcp server that provides real-time and historical Crypto Fear & Greed Index data, powered by the Alternative.me.
4 
5This 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.
6 
7![GitHub](https://img.shields.io/github/license/kukapay/crypto-feargreed-mcp) 
8![GitHub last commit](https://img.shields.io/github/last-commit/kukapay/crypto-feargreed-mcp) 
9![Python](https://img.shields.io/badge/python-3.10%2B-blue)
10 
11## Features
12 
13- **Current Index**: Retrieve the latest Fear & Greed Index value and classification.
14- **Historical Data**: Fetch historical index values for a specified number of days.
15- **Trend Analysis**: Analyze trends over time with statistics like average value and trend direction.
16- **Tool-Only Support**: Includes tool versions of all resources for compatibility with tool-only MCP clients.
17- **Prompt Generation**: Provides a prompt template for interpreting index values.
18 
19### Resources
20 
21- `fng://current`. Current crypto Fear & Greed Index. Output: 
22```
23Crypto Fear & Greed Index (as of 2025-03-15 00:00:00 UTC):
24Value: 45
25Classification: Fear
26```
27 
28- `fng://history/{days}`. Historical Data of Crypto Fear & Greed Index.Output:
29```
30Historical Crypto Fear & Greed Index:
312025-03-15 00:00:00 UTC: 45 (Fear)
322025-03-14 00:00:00 UTC: 48 (Fear)
33...
34```
35 
36### Tools
37 
38- `get_current_fng_tool() -> str`. 
39 
40Current Index. Same as `fng://current`
41 
42- `get_historical_fng_tool(days: int) -> str`. 
43 
44Historical Index Data. Same as `fng://history/{days}`
45 
46- `analyze_fng_trend(days: int) -> str`. 
47 
48Index trend Analysis. Output:
49```
50Fear & Greed Index Analysis (30 days):
51Latest Value: 45 (Fear) at 2025-03-15 00:00:00 UTC
52Average Value: 47.3
53Trend: falling
54Data points analyzed: 30
55```
56 
57### Prompts
58 
59- `interpret_fng`
60 
61Index Data Interpretation.
62 
63Output:
64```
65Please interpret this Crypto Fear & Greed Index value and explain what it means for cryptocurrency markets (specifically Bitcoin): 45
66```
67 
68## Installation
69 
70### Installing via Smithery
71 
72To install Crypto Fear & Greed Index for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kukapay/crypto-feargreed-mcp):
73 
74```bash
75npx -y @smithery/cli install @kukapay/crypto-feargreed-mcp --client claude
76```
77 
78Clone the repository:
79 
80```bash
81git clone https://github.com/kukapay/crypto-feargreed-mcp.git
82cd crypto-feargreed-mcp
83```  
84 
85Install for Claude Desktop
86```
87mcp install main.py --name "CryptoFearGreed"
88```
89Then enable it in your Claude Desktop configuration.
90 
91For other clients, add a server entry to your configuration file:
92 
93```
94"mcpServers": { 
95  "crypto-feargreed-mcp": { 
96    "command": "uv", 
97    "args": [ 
98      "--directory", "/your/path/to/crypto-feargreed-mcp", 
99      "run", 
100      "main.py" 
101    ]
102  } 
103}
104```
105 
106## Examples
107 
108After installation, ask:
109 
110- "What's the current Crypto Fear & Greed Index?"
111- "Show me the Crypto Fear & Greed Index trend for the last 30 days." 
112 
113Claude will automatically call the appropriate tools and provide responses.
114 
115## License
116This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
117 
118## Acknowledgments
119 
120- Built with [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk).
121- Data provided by [Alternative.me Fear & Greed Index API](https://api.alternative.me/fng/).