Skip to main content
Glama
crypto-feargreed-mcp

crypto-feargreed-mcp

by kukapay

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.

GitHub GitHub last commit Python

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

Related MCP server: funding-rates-mcp

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

Available Tools

3 tools
analyze_fng_trendA

Analyze trends in Crypto Fear & Greed Index over specified days.

Parameters: days (int): Number of days to analyze (must be a positive integer).

Returns: str: A string containing the analysis results, including latest value, average value, trend direction, and number of data points analyzed.

Inputs: days (required).

get_current_fng_toolB

Get the current Crypto Fear & Greed Index as a tool.

Inputs: no named parameters.

get_historical_fng_toolC

Get historical Fear & Greed Index for specified number of days as a tool.

Parameters: days (int): Number of days to retrieve (must be a positive integer).

Returns: str: Historical Fear & Greed Index values for the specified period.

Inputs: days (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 3 tools

    Disambiguation2/5

    The tools have overlapping purposes that could cause confusion. 'analyze_fng_trend' and 'get_historical_fng_tool' both retrieve historical data with a 'days' parameter, making their boundaries unclear. 'get_current_fng_tool' is distinct but the other two appear to serve similar functions with minor differences in output format.

    Naming Consistency3/5

    The naming follows a mixed convention. 'analyze_fng_trend' uses snake_case with a verb_noun pattern, while 'get_current_fng_tool' and 'get_historical_fng_tool' also use snake_case but append '_tool' inconsistently. The pattern is readable but lacks full consistency across all tools.

    Tool Count4/5

    With 3 tools, the count is reasonable for a focused server on Crypto Fear & Greed Index data. It's slightly thin but covers current, historical, and trend analysis, which aligns well with the domain scope without being overly complex.

    Completeness3/5

    The tool surface covers basic retrieval and analysis of the index, but there are notable gaps. For example, there's no tool for comparing multiple time periods, setting alerts, or integrating with other crypto data, which could limit agent workflows in a broader crypto analysis context.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers