Crypto Sentiment

Crypto Sentiment

What is Crypto Sentiment about?

Crypto Sentiment delivers real‑time cryptocurrency sentiment metrics—such as sentiment balance, social volume, social dominance, trending words, and shift alerts—by querying Santiment’s social media and news data. The data is exposed through an MCP server so AI agents can request and act on market mood insights.

How to use Crypto Sentiment?

1. Clone the repo

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

2. Set the Santiment API key in the MCP configuration (see serverConfig below) or export it as an environment variable SANTIMENT_API_KEY.
3. Start the MCP server using the command defined in the configuration. The server will listen for MCP‑compatible client requests.
4. Call the provided tools (get_sentiment_balance, get_social_volume, alert_social_shift, get_trending_words, get_social_dominance) from your AI agent or client code, passing the required parameters (asset symbol, days, thresholds, etc.).

Key Features

• Sentiment Balance – average positive vs. negative sentiment for a crypto asset over a configurable period.
• Social Volume Tracking – total number of mentions on social platforms, with optional spike/drop detection.
• Social Dominance – percentage share of crypto media discussions attributed to a specific asset.
• Trending Words – top‑n terms driving conversation in the crypto space.
• Social Shift Alerts – automatic detection of significant changes in social volume based on a threshold.

Use Cases

• AI trading bots that adjust strategies based on sentiment spikes or declines.
• Portfolio managers monitoring social dominance to gauge market attention.
• Research analysts extracting trending topics for market reports.
• Chat‑based assistants answering user queries about crypto sentiment in natural language.

FAQ

• Which API key is required? A Santiment API key (free or paid) must be supplied via SANTIMENT_API_KEY.
• What Python version is supported? Python 3.10 or higher.
• Can I change the default analysis period? Yes, most tools accept a days argument to specify the look‑back window.
• How do I customize the spike threshold? Use the threshold parameter of alert_social_shift (default = 50.0 %).
• Is the project open source? Yes, it is released under the MIT License.

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.