Crypto Sentiment MCP

🚀 Crypto Sentiment Analysis MCP Server

This is an MCP server that offers cryptocurrency sentiment analysis services for AI agents. It leverages Santiment's aggregated social media and news data to track market sentiment and uncover emerging trends.

✨ Features

• Sentiment Analysis: Obtain the sentiment balance (comparison between positive and negative) of a specific cryptocurrency.
• Social Volume Tracking: Monitor the total number of social media mentions and detect significant changes (spikes or drops).
• Social Dominance: Measure an asset's share in .crypto media discussions.
• Trending Words: Identify the most popular terms in cryptocurrency discussions.

🛠️ Tools

📋 Prerequisites

• Python: Version 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 the 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"
         }
       }
     }
   }
   

💻 Usage Examples

Query the current price of Bitcoin

Input:

{
  "id": "get_bitcoin_price",
  "method": "GET",
  "url": "http://localhost:8000/api/bitcoin/price"
}

Output:

{
  "response": {
    "price": 50, 
    "currency": "USD"
  }
}

Get the market data of Ethereum

Input:

{
  "id": "get_ethereum_data",
  "method": "GET",
  "url": "http://localhost:8000/api/ethereum/data"
}

Output:

{
  "response": {
    "symbol": "ETH",
    "price": 3.5,
    "market_cap": 1000000000,
    "volume_24h": 500000000
  }
}

Monitor the prices of multiple cryptocurrencies

Input:

{
  "id": "monitor_prices",
  "method": "GET",
  "url": "http://localhost:8000/api/monitor/prices"
}

Output:

{
  "response": {
    "bitcoin": { "price": 50, "change_24h": "+2.5%" },
    "ethereum": { "price": 3.5, "change_24h": "-1.5%" },
    "solana": { "price": 1.2, "change_24h": "+5.0%" }
  }
}

📄 License

This project is licensed under the MIT License.