Access Crypto Fear & Greed Index Data
crypto-feargreed-mcp brings live and historical Crypto Fear and Greed Index data from Alternative.me into Claude with trend analysis.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Integrate real-time and historical cryptocurrency Fear & Greed Index data into your applications. This MCP server simplifies sentiment analysis by providing easy access to market sentiment metrics.
Outcomes
What it gets done
Retrieve the latest Fear & Greed Index value and its classification.
Fetch historical index values for a specified period.
Analyze market sentiment trends with statistical insights.
Utilize provided tools for direct integration into MCP clients.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-crypto-feargreed-mcp | bash Capabilities
Tools your agent gets
Get the latest Fear & Greed Index value and its classification
Get historical index values for a specified number of days
Analyze trends over time with statistics such as average value and trend direction
Overview
crypto-feargreed-mcp server
crypto-feargreed-mcp exposes the Alternative.me Crypto Fear & Greed Index as MCP resources and tools: current value, historical data by day range, and a trend-analysis tool that computes average value and direction over a window. Use it when an assistant needs current or historical crypto sentiment data, such as answering trend questions or feeding sentiment into a trading or research workflow. It is scoped to this one index only, not general market data.
What it does
crypto-feargreed-mcp is an MCP server that exposes the Crypto Fear & Greed Index, powered by data from Alternative.me. It provides two resources for direct lookups: fng://current returns the latest index value and classification (for example, a value of 45 classified as "Fear"), and fng://history/{days} returns historical index values for a specified number of days, each with its date, value, and classification. On the tool side, get_current_fng_tool() and get_historical_fng_tool(days) mirror the two resources for MCP clients that only support tools rather than resources. A third tool, analyze_fng_trend(days), goes further than a raw dump: it computes statistics over the requested window, including the latest value and classification, the average value, the overall trend direction (for example "falling"), and the number of data points analyzed. A prompt template, interpret_fng, builds a ready-to-use prompt asking for an interpretation of a given index value and what it means for cryptocurrency markets, specifically Bitcoin.
When to use - and when NOT to
Use it when an agent or workflow needs current or historical crypto market sentiment - for example, answering "what's the current Fear & Greed Index?" or "show me the trend for the last 30 days", or feeding sentiment data into a broader trading or research assistant. It is not a fit for anything beyond this single sentiment metric: it does not provide price data, order books, or any other market data itself - it is scoped entirely to the Fear & Greed Index as published by Alternative.me.
Capabilities
- 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, including average value and trend direction.
- Tool-Only Support: every resource is also available as an equivalent tool, for MCP clients that only support tool calls.
- Prompt Generation: a prompt template for interpreting what a given index value means for the market.
How to install
The recommended path is installing via Smithery for Claude Desktop:
npx -y @smithery/cli install @kukapay/crypto-feargreed-mcp --client claude
Alternatively, clone the repository directly and run it manually:
git clone https://github.com/kukapay/crypto-feargreed-mcp.git
cd crypto-feargreed-mcp
For Claude Desktop specifically, it can also be installed with mcp install main.py --name "CryptoFearGreed" and then enabled in the Claude Desktop configuration. For other MCP clients, a config entry specifies the uv command with a --directory flag pointing at the cloned repo, running main.py. The project is released under the MIT License.
Who it's for
Crypto traders and researchers who want sentiment data available to an AI assistant without leaving the conversation, and developers building trading-assistant or market-research agents that need a lightweight, single-purpose sentiment signal alongside their other data sources.
Source 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
Installing via Smithery
To install Crypto Fear & Greed Index for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @kukapay/crypto-feargreed-mcp --client claude
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 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.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.