Crypto Fear & Greed Index

Crypto Fear & Greed Index

What is Crypto Fear & Greed Index about?

Offers access to the latest and historical values of the Crypto Fear & Greed Index, sourced from Alternative.me, through MCP‑compatible resources. The service delivers sentiment scores and classifications (e.g., Fear, Greed) that help assess cryptocurrency market mood.

How to use Crypto Fear & Greed Index?

1. Installation
   • Clone the repository:

     git clone https://github.com/kukapay/crypto-feargreed-mcp.git
     cd crypto-feargreed-mcp
     

   • Install for Claude Desktop (or other MCP clients) using the MCP SDK:

     mcp install main.py --name "CryptoFearGreed"
     

   • For other MCP configurations, add an entry to your client’s mcpServers section:

     "mcpServers": { 
       "crypto-feargreed-mcp": { 
         "command": "uv", 
         "args": [ "--directory", "/path/to/crypto-feargreed-mcp", "run", "main.py" ]
       } 
     }
     

2. Calling resources
   • Current index: fng://current or get_current_fng_tool().
   • Historical data: fng://history/{days} or get_historical_fng_tool(days).
   • Trend analysis: analyze_fng_trend(days).
   • Prompt generation: interpret_fng.

Key Features

• Current Index – Retrieve the latest value and classification.
• Historical Data – Fetch index values for a user‑specified number of past days.
• Trend Analysis – Compute average value, direction (rising/falling), and summary statistics.
• Tool‑Only Support – All resources are exposed as tools for environments that only support tool calls.
• Prompt Template – Generates a ready‑to‑use prompt for interpreting a specific index value.

Use Cases

• Market Sentiment Monitoring – Continuously gauge crypto market mood for trading desks.
• Automated Trading Strategies – Trigger buy/sell decisions based on fear or greed thresholds.
• Reporting Dashboards – Populate charts and reports with historical sentiment data.
• Educational Platforms – Teach newcomers about market psychology using real‑time indices.

FAQ

• Do I need an API key? No. The server fetches data from the publicly available Alternative.me API.
• How many days of history can I request? The external API typically allows up to several months; you can specify any integer within that range.
• Which clients are supported? Any MCP‑compatible client, such as Claude Desktop, as well as custom MCP integrations.
• How often is the data refreshed? The source updates daily at 00:00 UTC; the current resource reflects the most recent value.

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.