Crypto Sentiment

What is Crypto Sentiment about?

Provides AI agents with real‑time cryptocurrency sentiment insights derived from Santiment's social media and news feeds. It tracks market mood, social mentions, asset dominance, and emerging discussion keywords.

How to use Crypto Sentiment?

1. Clone the repository and install the required Python version (3.10+).
2. Set the SANTIMENT_API_KEY environment variable with a valid Santiment API key.
3. Run the MCP server using the provided configuration (see serverConfig).
4. Invoke the exposed tools (get_sentiment_balance, get_social_volume, alert_social_shift, get_trending_words, get_social_dominance) from an MCP‑compatible client or via HTTP requests, passing the required parameters.

Key Features of Crypto Sentiment

• Sentiment Balance – Average positive vs. negative sentiment for any asset over a configurable period.
• Social Volume – Total number of social media mentions for an asset.
• Social Shift Alerts – Detect spikes or drops in mention volume against a historical average.
• Trending Words – Top‑ranked keywords in crypto discussions.
• Social Dominance – Percentage share of overall crypto media discussion occupied by an asset.

Use Cases of Crypto Sentiment

• Trading bots can adjust strategies based on sentiment spikes or downturns.
• Portfolio dashboards enrich performance data with sentiment and dominance metrics.
• Research analysts monitor emerging topics and market perception trends.
• AI assistants answer natural‑language queries about crypto market mood.

FAQ

Q: Which API key is required? A: A Santiment API key (free or paid) set in the SANTIMENT_API_KEY environment variable.

Q: Can I change the default look‑back period? A: Yes, each tool accepts a days parameter (default 7) to adjust the analysis window.

Q: How does the spike detection work? A: alert_social_shift compares the latest daily volume to the average of the preceding days and triggers when the percentage change exceeds the supplied threshold.

Q: Is there rate limiting? A: Limits are imposed by the Santiment API tier you use; handle HTTP 429 responses accordingly.

Crypto Sentiment MCP Server

An MCP server that delivers cryptocurrency sentiment analysis to AI agents, leveraging Santiment's aggregated social media and news data to track market mood and detect emerging trends.

Features

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

Tools

Prerequisites

• Python: 3.10 or higher
• Santiment API Key: Obtain a free or paid key from Santiment.

Installation

1. Clone the Repository:

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

2. Configure 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"
         }
       }
     }
   }
   

Examples

Below are examples of natural language inputs and their corresponding outputs when interacting with the server via an MCP-compatible client:

• Input: "What's the sentiment balance for Bitcoin over the last week?"

  • Output: "Bitcoin's sentiment balance over the past 7 days is 12.5."

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

  • Output: "Ethereum's social volume over the past 5 days is 8,432 mentions."

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

  • Output: "Bitcoin's social volume spiked by 75.0% in the last 24 hours, from an average of 1,000 to 1,750."

• Input: "What are the top 3 trending words in crypto over the past 3 days?"

  • Output: "Top 3 trending words over the past 3 days: 'halving', 'bullrun', 'defi'."

• Input: "How dominant is Ethereum in social media discussions this week?"

  • Output: "Ethereum's social dominance over the past 7 days is 18.7%."

License

This project is licensed under the MIT License - see the LICENSE file for details.