# MCP Server Fear Greed

> MCP Server Fear Greed is an open-source MCP server for finance and payments. MCP server that returns the CNN Fear & Greed Index for US stocks to AI clients. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted, vscode
- **Repository:** https://github.com/ycjcl868/mcp-server-fear-greed
- **MCP Registry name:** io.github.ycjcl868/mcp-server-fear-greed
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The README describes a server that pulls the CNN Fear & Greed Index, a 0-100 gauge of US stock market sentiment, and exposes it to MCP-compatible clients. Each reading comes with prior-close, one-week, one-month and one-year comparison values, so a client can see whether sentiment is shifting.

The server publishes a single tool, get_fear_greed_index, which returns either formatted markdown or raw JSON. The JSON breaks the index into component indicators such as S&P 500 momentum, stock price strength and breadth, put/call options ratio, VIX volatility, junk bond demand and safe haven demand, each with its own score and rating band.

It runs locally over stdio via npx, or as an SSE or streamable HTTP server on a chosen port. It is aimed at developers and traders who want market sentiment available inside an AI assistant or agent workflow.

## Features

- **Composite sentiment score:** Returns the current 0-100 Fear & Greed reading along with its rating label.
- **Historical comparisons:** Includes previous close and week, month and year values for context on trend.
- **Component indicators:** Breaks the index into momentum, breadth, options, volatility and bond demand scores.
- **Flexible output formats:** Choose formatted markdown or raw JSON from the same tool call.
- **Multiple transports:** Runs over stdio for local clients or as SSE and streamable HTTP endpoints.
- **In-process usage:** The README shows importing createServer for direct use from JavaScript or TypeScript.

## Good for

- Adding current US market sentiment to an AI assistant's answers
- Checking whether the market is in fear or greed before a trading review
- Building a dashboard or agent that tracks sentiment changes over time
- Pulling index components into a JavaScript app without a separate API integration

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server-fear-greed -- npx -y mcp-server-fear-greed
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fear-greed"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fear-greed"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server-fear-greed": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fear-greed"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fear-greed"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fear-greed"
      ]
    }
  }
}
```

## Tools

- `get_fear_greed_index`: Fetches the current Fear & Greed Index and related market indicators, returned as markdown or JSON.

## FAQ

### What tool does the server expose?

It exposes one tool, get_fear_greed_index, which takes an optional format parameter set to structured (default) or json.

### How is the server installed?

The README gives configurations that run it with npx mcp-server-fear-greed@latest, and it can also be started with a --port flag for remote transports.

### What does the rating scale look like?

The README lists 0-25 as Extreme Fear, 26-45 as Fear, 46-55 as Neutral, 56-75 as Greed and 76-100 as Extreme Greed.

### What Node.js version is required?

The README states Node.js 18 or newer.

### Is MCP Server Fear Greed free?

Yes. MCP Server Fear Greed is open source, so you can use and self-host it for free.

### How do I add MCP Server Fear Greed to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-fear-greed -- npx -y mcp-server-fear-greed

### What are the best alternatives to MCP Server Fear Greed?

The closest alternatives to MCP Server Fear Greed are MCP, stocks-llm, StocksScores, EchoPai (回声投研) and NakamotoNotes Bitcoin Barometer.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [MCP](https://ai-powered.com/mcp/mcp-mweotk04): MCP is a freemium MCP server for finance and payments.
- [stocks-llm](https://ai-powered.com/mcp/stocks-llm): stocks-llm is a free MCP server for finance and payments.
- [StocksScores](https://ai-powered.com/mcp/stocksscores): StocksScores is a free MCP server for finance and payments.
- [EchoPai (回声投研)](https://ai-powered.com/mcp/echopai): EchoPai (回声投研) is an MCP server for finance and payments.
- [NakamotoNotes Bitcoin Barometer](https://ai-powered.com/mcp/nakamotonotes-bitcoin-barometer): NakamotoNotes Bitcoin Barometer is a free MCP server for finance and payments.
- [MarketFrame](https://ai-powered.com/mcp/marketframe): MarketFrame is a free MCP server for finance and payments.
- [Cryptokly](https://ai-powered.com/mcp/cryptokly): Cryptokly is an MCP server for finance and payments.
- [Bitculator](https://ai-powered.com/mcp/bitculator): Bitculator is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/mcp-server-fear-greed
