Crypto Sentiment MCP Server

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](https://app.santiment.net/).

Installation

1. **Clone the Repository**: ```bash 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

• **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