crypto-feargreed-mcp

What is crypto-feargreed-mcp?

crypto-feargreed-mcp is a server that provides real-time and historical Crypto Fear & Greed Index data. It is powered by the Alternative.me API and is designed to be easily integrated with MCP-compatible clients, such as Claude Desktop.

How to use crypto-feargreed-mcp?

To use crypto-feargreed-mcp, you can install it via Smithery for Claude Desktop or manually clone the repository and install it. After installation, you can interact with it through natural language queries in MCP-compatible clients. For example, you can ask "What's the current Crypto Fear & Greed Index?" or "Show me the Crypto Fear & Greed Index trend for the last 30 days."

Key Features of crypto-feargreed-mcp

• 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: Exposes fng://current for current data and fng://history/{days} for historical data.
• Tools: Provides get_current_fng_tool(), get_historical_fng_tool(days: int), and analyze_fng_trend(days: int) for programmatic access.
• Prompts: Includes interpret_fng for interpreting index values.

Use Cases of crypto-feargreed-mcp

• Cryptocurrency Market Analysis: Integrate real-time and historical Fear & Greed Index data into your analysis workflows.
• Automated Trading Strategies: Use the index data to inform and trigger automated trading decisions.
• Educational Purposes: Understand the sentiment of the cryptocurrency market over time.
• Integration with AI Assistants: Easily access and interpret market sentiment through AI assistants like Claude Desktop.

FAQ about crypto-feargreed-mcp

• What is the Crypto Fear & Greed Index? The Crypto Fear & Greed Index is a tool that measures the current sentiment of the cryptocurrency market. It ranges from 0 (Extreme Fear) to 100 (Extreme Greed).
• Where does the data come from? The data is powered by the Alternative.me Fear & Greed Index API.
• What clients are supported? It is designed for MCP-compatible clients, with specific instructions for Claude Desktop.
• Is there a license? Yes, the project is licensed under the MIT License.

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.