An MCP server that provides cryptocurrency sentiment analysis for AI agents, using aggregated social media and news data from Santiment to track market sentiment and discover emerging trends.

Installation

From source code

git clone https://github.com/kukapay/crypto-sentiment-mcp.git
cd crypto-sentiment-mcp

Configuration

MCP client

{
  "mcpServers": {
    "crypto-sentiment-mcp": {
      "command": "uv",
      "args": ["--directory", "path/to/crypto-sentiment-mcp", "run", "main.py"],
      "env": {
        "SANTIMENT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Tool	Description
get_sentiment_balance	Get the average sentiment balance for an asset over a specified period
get_social_volume	Get the total number of mentions on social media for an asset
alert_social_shift	Detect significant spikes or drops in social volume compared to the previous average
get_trending_words	Get the top trending words in crypto discussions, ranked by score for the period
get_social_dominance	Measure the percentage of crypto media discussions dominated by an asset

Features

• Sentiment Analysis: Get sentiment balance (positive vs negative) for specific cryptocurrencies
• Social Volume Tracking: Monitor total social media mentions and detect significant changes (spikes or drops)
• Social Dominance: Measure the share of discussions an asset occupies in crypto media
• Trending Words: Identify the most popular terms gaining traction in cryptocurrency discussions

Environment Variables

Required

• SANTIMENT_API_KEY - Santiment API key for accessing cryptocurrency sentiment and social media data

Usage Examples

What's the sentiment balance for Bitcoin over the last week?

How many times has Ethereum been mentioned on social media in the past 5 days?

Tell me if there's been a big change in Bitcoin's social volume recently, with a 30% threshold.

What are the top 3 trending words in crypto over the past 3 days?

How dominant is Ethereum in social media discussions this week?

Notes

Requires Python 3.10 or higher and a Santiment API key (free or paid) from app.santiment.net