https://github.com/kukapay/crypto-feargreed-mcp
Providing real-time and historical Crypto Fear & Greed Index data
https://github.com/kukapay/crypto-feargreed-mcp
Last synced: 3 months ago
JSON representation
Providing real-time and historical Crypto Fear & Greed Index data
- Host: GitHub
- URL: https://github.com/kukapay/crypto-feargreed-mcp
- Owner: kukapay
- License: mit
- Created: 2025-03-15T11:46:17.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-15T12:32:09.000Z (3 months ago)
- Last Synced: 2025-03-15T13:29:12.057Z (3 months ago)
- Language: Python
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-list - kukapay/crypto-feargreed-mcp - feargreed-mcp?style=social)](https://github.com/kukapay/crypto-feargreed-mcp): Provides real-time and historical Crypto Fear & Greed Index data. (Uncategorized / Uncategorized)
- awesome-mcp-zh - kukapay/crypto-feargreed-mcp
- awesome-mcp-servers - kukapay/crypto-feargreed-mcp - Providing real-time and historical Crypto Fear & Greed Index data. (Legend / 💰 <a name="finance--fintech"></a>Finance & Fintech)
- Awesome-MCP-Servers-directory - crypto-feargreed-mcp - Providing real-time and historical Crypto Fear & Greed Index data (Finance)
- awesome-mcp-servers - Crypto Fear & Greed Index Server - Providing real-time and historical Crypto Fear & Greed Index data (Table of Contents / Finance)
- awesome-mcp-servers - Crypto Fear & Greed Index Server - Providing real-time and historical Crypto Fear & Greed Index data (Table of Contents / Finance)
- mcp-index - Crypto Fear & Greed Index - Provides access to real-time and historical Crypto Fear & Greed Index data for market sentiment analysis and trend evaluation. Users can retrieve the latest index values and analyze historical trends over specified periods. (Financial Data and Stock Market)
README
# 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/).