MCP Connector

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.


90
Spark score
out of 100
Updated May 2025
Version 1.0.0
Models
universal

Add 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

01

Retrieve the latest Fear & Greed Index value and its classification.

02

Fetch historical index values for a specified period.

03

Analyze market sentiment trends with statistical insights.

04

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_current_fng_tool

Get the latest Fear & Greed Index value and its classification

get_historical_fng_tool

Get historical index values for a specified number of days

analyze_fng_trend

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.

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

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.