crypto-sentiment-mcp is an MCP server used to provide cryptocurrency sentiment analysis to AI agents. It leverages social media and news data aggregated by Santiment to track market sentiment and detect emerging trends.
Main capabilities:
- Sentiment analysis: Retrieve the sentiment balance (positive vs. negative) for a specific cryptocurrency, for example returning "Bitcoin's sentiment balance over the past 7 days is 12.5."
- Social volume tracking: Monitor the total number of social media mentions and detect significant changes (spikes or drops), for example "Ethereum's social volume over the past 5 days is 8,432 mentions."
- Social dominance: Measure an asset's share of crypto media discussion, for example "Ethereum's social dominance over the past 7 days is 18.7%."
- Trending words: Identify the most popular terms in cryptocurrency discussions, for example "Top 3 trending words over the past 3 days: 'halving', 'bullrun', 'defi'."
Usage:
- Environment requirements: Python 3.10 or higher; a Santiment API key is required (free or paid keys are available from Santiment).
- Installation: Clone the repository with the command: git clone https://github.com/kukapay/crypto-sentiment-mcp.git Then cd crypto-sentiment-mcp.
- Configure the client: Add the following configuration in an MCP-compatible 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" } } } }
Use cases: This server is suitable for scenarios that require AI agents to query cryptocurrency market sentiment, social discussion heat, asset opinion dominance, and popular topics. Users can ask questions in natural language through an MCP-compatible client, for example: "What is Bitcoin's sentiment balance over the past week?", "How many times has Ethereum been mentioned on social media over the past 5 days?", "Tell me whether Bitcoin's social volume has changed significantly recently, with a threshold of 30%.", "What are the top 3 trending words in the crypto space over the past 3 days?", "What is Ethereum's dominance in social media discussions this week?".
Limitations: The project uses the MIT license. Usage requires a Santiment API key, and the data depends on aggregated social media and news data provided by Santiment. Other platform limitations or pricing details are not provided at this time.
