crypto-sentiment-mcp

What is crypto-sentiment-mcp?

Crypto-sentiment-mcp is an MCP (Multi-Chain Protocol) server designed to provide AI agents with real-time cryptocurrency sentiment analysis. It achieves this by leveraging Santiment's aggregated social media and news data, enabling the tracking of market mood and the detection of emerging trends within the cryptocurrency space.

How to use crypto-sentiment-mcp?

To use crypto-sentiment-mcp, you need Python 3.10 or higher and a Santiment API Key. After cloning the repository, you configure the client by setting the command to uv, args to ["--directory", "path/to/crypto-sentiment-mcp", "run", "main.py"], and env to include your SANTIMENT_API_KEY. Once configured, AI agents can interact with the server using natural language inputs to retrieve sentiment data.

Key Features of crypto-sentiment-mcp

• Sentiment Analysis: Retrieves sentiment balance (positive vs. negative) for specific cryptocurrencies.
• Social Volume Tracking: Monitors total social media mentions and detects significant shifts (spikes or drops).
• Social Dominance: Measures the share of discussions an asset occupies in crypto media.
• Trending Words: Identifies the most popular terms trending in cryptocurrency discussions.

Use Cases of crypto-sentiment-mcp

• Market Trend Detection: Identify emerging trends in cryptocurrency discussions by analyzing sentiment and social volume.
• Automated Trading Strategies: AI agents can use sentiment data to inform automated trading decisions.
• Market Research: Gain insights into public perception and discussion around specific cryptocurrencies.
• Risk Management: Detect sudden shifts in social volume that might indicate potential market volatility.

FAQ about crypto-sentiment-mcp

• Q: What is the sentiment balance for Bitcoin over the last week?
  • A: Bitcoin's sentiment balance over the past 7 days is 12.5.
• Q: How many times has Ethereum been mentioned on social media in the past 5 days?
  • A: Ethereum's social volume over the past 5 days is 8,432 mentions.
• Q: Tell me if there's been a big change in Bitcoin's social volume recently, with a 30% threshold.
  • A: Bitcoin's social volume spiked by 75.0% in the last 24 hours, from an average of 1,000 to 1,750.
• Q: What are the top 3 trending words in crypto over the past 3 days?
  • A: Top 3 trending words over the past 3 days: 'halving', 'bullrun', 'defi'.
• Q: How dominant is Ethereum in social media discussions this week?
  • A: Ethereum's social dominance over the past 7 days is 18.7%.

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.