Crypto Fear & Greed Index

What is Crypto Fear & Greed Index about?

A server that delivers the latest Crypto Fear & Greed Index value, historical series for a configurable number of days, and trend analysis statistics, all sourced from Alternative.me.

How to use Crypto Fear & Greed Index?

1. Installation – Install via Smithery or clone the repo and run uv run main.py.
2. MCP Configuration – Add a server entry to your MCP client configuration (e.g., Claude Desktop) pointing to the command that starts main.py.
3. Calling Resources – Use resource URIs such as fng://current for the latest value or fng://history/30 for the past 30 days.
4. Tools – Invoke provided tool functions (get_current_fng_tool, get_historical_fng_tool, analyze_fng_trend) from MCP‑compatible clients.
5. Prompts – Use the interpret_fng prompt template to obtain natural‑language explanations of a specific index value.

Key Features of Crypto Fear & Greed Index

• Current Index – Retrieves the most recent Fear & Greed value and its classification.
• Historical Data – Returns a list of index values for a user‑specified number of days.
• Trend Analysis – Calculates average value, direction (rising/falling), and other statistics over the requested period.
• Tool‑Only Support – All resources are exposed as callable tools for clients that operate without direct URI calls.
• Prompt Generation – Built‑in prompt template for interpreting a numeric index in market‑context language.

Use Cases of Crypto Fear & Greed Index

• Trading Decision Support – Bots can fetch the index and adjust risk exposure based on fear or greed levels.
• Portfolio Reporting – Generate daily or weekly sentiment summaries for investors.
• Research & Analytics – Combine index trends with price data to study correlation patterns.
• Educational Tools – Teach newcomers about market sentiment using real‑time examples.

FAQ from the Crypto Fear & Greed Index

Q: Do I need an API key? A: No API key is required; the server proxies data from Alternative.me.

Q: Which programming languages can I use? A: Any MCP‑compatible client (Claude Desktop, custom adapters, etc.) can call the resources or tools.

Q: How far back can I request historical data? A: Up to the number of days provided by the Alternative.me API; typical limits are several years.

Q: Can I customize the trend analysis period? A: Yes, pass the desired number of days to analyze_fng_trend(days).

Q: How do I install the server quickly? A: Use Smithery:

npx -y @smithery/cli install @kukapay/crypto-feargreed-mcp --client claude

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.

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.