# Crypto News Sentiment (x402)

> Crypto News Sentiment (x402) is a freemium MCP server for finance and payments. Crypto news sentiment for 24 coins, with the headlines behind each score, paid per call. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://crypto-sentiment-x402.onrender.com
- **Repository:** https://github.com/whatevercat-creator/crypto-sentiment-x402
- **MCP Registry name:** io.github.whatevercat-creator/crypto-sentiment-x402
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

Each reading comes from recent headlines at nine crypto outlets plus the Fear & Greed Index, scored with VADER and a crypto slang lexicon. Only the last 72 hours count, and a headline's weight halves every 24 hours. The result is a bullish, bearish or neutral label, a score from -1 to 1, the sample size and up to five headlines that moved it most. When fewer than the needed headlines exist, it says insufficient recent news and does not charge.

The local MCP server wraps the hosted API. Its paid tools, get_sentiment, get_sentiment_history and get_movers, sign x402 payments from your own Coinbase CDP wallet in USDC on Base, with a per-session spend cap of 0.50 USD by default and a check that the payee address matches. Free tools work without keys. The API lists $0.01 per sentiment call and $0.05 for hourly history, and monthly plans with a free tier of 100 calls.

The README is explicit that this is news sentiment only, not a price prediction or financial advice.

## Features

- **24 coins covered:** Includes BTC, ETH, SOL, XRP and 20 more tickers.
- **Visible drivers:** Each score lists up to five headlines with title, source and link.
- **Spend cap:** MAX_SPEND_USD_PER_SESSION defaults to 0.50 and refuses calls over it.
- **Refusals not charged:** Unsupported coins or too little news return an error without payment.
- **Hourly history:** History readings are recorded live each hour, up to 30 days per call.

## Good for

- Give a trading bot a news-based sentiment signal
- Check which headlines are moving sentiment for a coin
- Review hourly sentiment history for a week
- Find which tracked coins are moving

## Install

### Claude Code (Terminal)

```sh
claude mcp add crypto-sentiment-x402 --env CDP_API_KEY_ID='<CDP_API_KEY_ID>' --env CDP_API_KEY_SECRET='<CDP_API_KEY_SECRET>' -- uvx crypto-sentiment-x402-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "crypto-sentiment-x402": {
      "command": "uvx",
      "args": [
        "crypto-sentiment-x402-mcp"
      ],
      "env": {
        "CDP_API_KEY_ID": "<CDP_API_KEY_ID>",
        "CDP_API_KEY_SECRET": "<CDP_API_KEY_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "crypto-sentiment-x402": {
      "command": "uvx",
      "args": [
        "crypto-sentiment-x402-mcp"
      ],
      "env": {
        "CDP_API_KEY_ID": "<CDP_API_KEY_ID>",
        "CDP_API_KEY_SECRET": "<CDP_API_KEY_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "crypto-sentiment-x402": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "crypto-sentiment-x402-mcp"
      ],
      "env": {
        "CDP_API_KEY_ID": "<CDP_API_KEY_ID>",
        "CDP_API_KEY_SECRET": "<CDP_API_KEY_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "crypto-sentiment-x402": {
      "command": "uvx",
      "args": [
        "crypto-sentiment-x402-mcp"
      ],
      "env": {
        "CDP_API_KEY_ID": "<CDP_API_KEY_ID>",
        "CDP_API_KEY_SECRET": "<CDP_API_KEY_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "crypto-sentiment-x402": {
      "command": "uvx",
      "args": [
        "crypto-sentiment-x402-mcp"
      ],
      "env": {
        "CDP_API_KEY_ID": "<CDP_API_KEY_ID>",
        "CDP_API_KEY_SECRET": "<CDP_API_KEY_SECRET>"
      }
    }
  }
}
```

## Tools

- `get_sentiment`: Paid tool returning a sentiment reading for a coin.
- `get_sentiment_history`: Paid tool returning hourly sentiment history.
- `get_movers`: Paid tool for coins whose sentiment is moving.

## FAQ

### How much does a call cost?

$0.01 per sentiment call and $0.05 per history call over x402; the 402 response is the source of truth.

### Is there a monthly plan?

Yes: Free with 100 calls, Starter with 3,000 and Pro with 15,000 per month.

### Which tools need payment?

get_sentiment, get_sentiment_history and get_movers; the free tools do not.

### Can I test without real money?

Yes, set X402_NETWORK to testnet for Base Sepolia USDC.

### Is Crypto News Sentiment (x402) free?

Crypto News Sentiment (x402) has a free plan, with paid plans for more usage or features.

### How do I add Crypto News Sentiment (x402) to Claude Code?

Run this command in your terminal: claude mcp add crypto-sentiment-x402 --env CDP_API_KEY_ID='<CDP_API_KEY_ID>' --env CDP_API_KEY_SECRET='<CDP_API_KEY_SECRET>' -- uvx crypto-sentiment-x402-mcp

### What are the best alternatives to Crypto News Sentiment (x402)?

The closest alternatives to Crypto News Sentiment (x402) are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/crypto-news-sentiment-x402
