kukapay_crypto_feargreed_mcp
by kukapayCrypto Fear & Greed Index MCP Server
A server that provides real-time and historical Crypto Fear & Greed Index data, powered by the Alternative.me API. This server is designed to integrate seamlessly with MCP-compatible clients, including Claude Desktop, offering tools and resources for fetching and analyzing the Fear & Greed Index.
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
Retrieve the current Crypto Fear & Greed Index.
Output Example:
Crypto Fear & Greed Index (as of 2025-03-15 00:00:00 UTC):
Value: 45
Classification: Fear
fng://history/{days}
Fetch historical data for the Crypto Fear & Greed Index.
Output Example:
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
Retrieve the current index. Same as fng://current.
get_historical_fng_tool(days: int) -> str
Fetch historical index data. Same as fng://history/{days}.
analyze_fng_trend(days: int) -> str
Perform trend analysis on the index.
Output Example:
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
Generate a prompt for interpreting the index value.
Output Example:
Please interpret this Crypto Fear & Greed Index value and explain what it means for cryptocurrency markets (specifically Bitcoin): 45
Installation
-
Clone the repository:
shell git clone https://github.com/kukapay/crypto-feargreed-mcp.git cd crypto-feargreed-mcp -
Install for Claude Desktop:
shell mcp install main.py --name "CryptoFearGreed" -
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 file for details.
Acknowledgments
- Built with MCP Python SDK.
- Data provided by Alternative.me Fear & Greed Index API.
Invite Gmail Contacts
