Crypto Sentiment MCP Server

1# Crypto Sentiment MCP Server
2 
3An 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.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/crypto-sentiment-mcp)
6![Python Version](https://img.shields.io/badge/python-3.10+-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9 
10## Features
11 
12- **Sentiment Analysis**: Retrieve sentiment balance (positive vs. negative) for specific cryptocurrencies.
13- **Social Volume Tracking**: Monitor total social media mentions and detect significant shifts (spikes or drops).
14- **Social Dominance**: Measure the share of discussions an asset occupies in crypto media.
15- **Trending Words**: Identify the most popular terms trending in cryptocurrency discussions.
16 
17## Tools
18 
19| Tool Name               | Description                                                                                   | Parameters                                  |
20|-------------------------|-----------------------------------------------------------------------------------------------|---------------------------------------------|
21| `get_sentiment_balance` | Get the average sentiment balance for an asset over a specified period.                      | `asset: str`, `days: int = 7`              |
22| `get_social_volume`     | Fetch the total number of social media mentions for an asset.                                | `asset: str`, `days: int = 7`              |
23| `alert_social_shift`    | Detect significant spikes or drops in social volume compared to the previous average.        | `asset: str`, `threshold: float = 50.0`, `days: int = 7` |
24| `get_trending_words`    | Retrieve the top trending words in crypto discussions, ranked by score over a period.        | `days: int = 7`, `top_n: int = 5`          |
25| `get_social_dominance`  | Measure the percentage of crypto media discussions dominated by an asset.                    | `asset: str`, `days: int = 7`              |
26 
27## Prerequisites
28 
29- **Python**: 3.10 or higher
30- **Santiment API Key**: Obtain a free or paid key from [Santiment](https://app.santiment.net/). 
31 
32## Installation
33 
341. **Clone the Repository**:
35   ```bash
36   git clone https://github.com/kukapay/crypto-sentiment-mcp.git
37   cd crypto-sentiment-mcp
38   ```
39 
402. **Configure Client**:
41    ```
42    {
43      "mcpServers": {
44        "crypto-sentiment-mcp": {
45          "command": "uv",
46          "args": ["--directory", "path/to/crypto-sentiment-mcp", "run", "main.py"],
47          "env": {
48            "SANTIMENT_API_KEY": "your_api_key_here"
49          }
50        }
51      }
52    }
53    ```  
54 
55## Examples
56 
57Below are examples of natural language inputs and their corresponding outputs when interacting with the server via an MCP-compatible client:
58 
59- **Input**: "What's the sentiment balance for Bitcoin over the last week?"
60  - **Output**: "Bitcoin's sentiment balance over the past 7 days is 12.5."
61 
62- **Input**: "How many times has Ethereum been mentioned on social media in the past 5 days?"
63  - **Output**: "Ethereum's social volume over the past 5 days is 8,432 mentions."
64 
65- **Input**: "Tell me if there's been a big change in Bitcoin's social volume recently, with a 30% threshold."
66  - **Output**: "Bitcoin's social volume spiked by 75.0% in the last 24 hours, from an average of 1,000 to 1,750."
67 
68- **Input**: "What are the top 3 trending words in crypto over the past 3 days?"
69  - **Output**: "Top 3 trending words over the past 3 days: 'halving', 'bullrun', 'defi'."
70 
71- **Input**: "How dominant is Ethereum in social media discussions this week?"
72  - **Output**: "Ethereum's social dominance over the past 7 days is 18.7%."
73 
74 
75## License
76 
77This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
78