Crypto Sentiment MCP Server
AI-accessible crypto sentiment data powered by Santiment.
Key Features
Use Cases
README
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
| Tool Name | Description | Parameters |
|---|---|---|
get_sentiment_balance |
Get the average sentiment balance for an asset over a specified period. | asset: str, days: int = 7 |
get_social_volume |
Fetch the total number of social media mentions for an asset. | asset: str, days: int = 7 |
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 |
get_trending_words |
Retrieve the top trending words in crypto discussions, ranked by score over a period. | days: int = 7, top_n: int = 5 |
get_social_dominance |
Measure the percentage of crypto media discussions dominated by an asset. | asset: str, days: int = 7 |
Prerequisites
- Python: 3.10 or higher
- Santiment API Key: Obtain a free or paid key from Santiment.
Installation
-
Clone the Repository:
bashgit clone https://github.com/kukapay/crypto-sentiment-mcp.git cd crypto-sentiment-mcp -
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.
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
cryptopanic-mcp-server
Provides real-time cryptocurrency news to AI agents via Model Context Protocol.
cryptopanic-mcp-server delivers up-to-date cryptocurrency news to AI agents by integrating with the CryptoPanic API. It exposes an MCP-compliant server with a tool for fetching news or media headlines, supporting customization via API keys and configuration files. The implementation is intended for streamlined context integration into AI workflows, enhancing agent awareness with current crypto market updates.
- ⭐ 59
- MCP
- kukapay/cryptopanic-mcp-server
Crypto Trending MCP Server
Real-time trending cryptocurrency data via Model Context Protocol tools.
Crypto Trending MCP Server tracks and monitors the latest trending tokens on CoinGecko, providing real-time insights into the most popular cryptocurrencies. It exposes MCP tools and prompts, such as a Markdown generator for trending token data and a parser prompt for extracting and analyzing the results with AI models. The solution is built for seamless integration with clients like Claude Desktop and allows natural language querying of current crypto trends. Its lightweight and extensible design supports easy deployment and extension.
- ⭐ 6
- MCP
- kukapay/crypto-trending-mcp
Hive Intelligence MCP Server
Unified MCP server delivering advanced cryptocurrency and Web3 analytics.
Hive Intelligence MCP Server provides comprehensive cryptocurrency, DeFi, and Web3 analytics via the Model Context Protocol. It enables AI assistants to access and orchestrate over 200 specialized tools covering market data, on-chain analytics, portfolio tracking, and security analysis. The server offers both dynamic and category-specific analytics through a unified MCP interface, facilitating intelligent tool orchestration for diverse crypto data needs.
- ⭐ 7
- MCP
- hive-intel/hive-crypto-mcp
Freqtrade-MCP
MCP server bridge for Freqtrade automated crypto trading bots
Freqtrade-MCP acts as a Model Context Protocol (MCP) server that connects AI agents to the Freqtrade cryptocurrency trading bot via its REST API. It exposes Freqtrade operations as standardized MCP tools, enabling automated trading workflows through programmatic access. The system ensures AI agents can manage market data, trigger trades, and monitor performance in a uniform context protocol environment. It supports secure and configurable deployment with support for relevant API endpoints.
- ⭐ 92
- MCP
- kukapay/freqtrade-mcp
Octagon MCP Server
AI-powered financial research and market intelligence via MCP.
Octagon MCP Server enables specialized, AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API. It provides the ability to analyze public filings, earnings call transcripts, financial metrics, stock data, and private market transactions within Claude Desktop and other MCP-compatible clients. The server orchestrates multiple specialized agents for comprehensive market analysis and can aggregate, extract, and structure data from financial sources and public websites. Designed for seamless use in standardized Model Context Protocol environments, it supports rapid integration into advanced AI workflows.
- ⭐ 78
- MCP
- OctagonAI/octagon-mcp-server
TheGraph MCP Server
Empowering AI agents with indexed blockchain data from The Graph
TheGraph MCP Server provides AI agents with seamless access to indexed blockchain data through The Graph protocol. It offers tools for fetching subgraph schemas and executing custom GraphQL queries, making blockchain data exploration efficient for AI-powered applications. The server is tailored for easy integration as a Model Context Protocol (MCP) server, enabling intelligent context-aware data retrieval.
- ⭐ 7
- MCP
- kukapay/thegraph-mcp
Didn't find tool you were looking for?