Crypto Sentiment MCP Server

Name: Crypto Sentiment MCP Server
Author: kukapay

@kukapay

Repository

About Crypto Sentiment MCP Server

An MCP server that delivers cryptocurrency sentiment analysis to AI agents.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "crypto-sentiment-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/crypto-sentiment-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "SANTIMENT_API_KEY": ""
      }
    }
  }
}

Tools

Get the average sentiment balance for an asset over a specified period.

Fetch the total number of social media mentions for an asset.

Detect significant spikes or drops in social volume compared to the previous average.

Retrieve the top trending words in crypto discussions, ranked by score over a period.

Measure the percentage of crypto media discussions dominated by an asset.

Overview

What is 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.

How to use Crypto Sentiment MCP Server?

Clone the repository, then configure your MCP client with the server command (uv --directory path/to/crypto-sentiment-mcp run main.py) and set the SANTIMENT_API_KEY environment variable.

Key features of Crypto Sentiment MCP Server

Retrieve sentiment balance (positive vs. negative) for a cryptocurrency.
Track total social media mentions and detect significant shifts.
Measure the share of discussions an asset dominates in crypto media.
Identify top trending words in cryptocurrency discussions.
Alert on social volume spikes or drops compared to previous averages.

Use cases of Crypto Sentiment MCP Server

Ask for the average sentiment balance of Bitcoin over the past week.
Get the total social media mentions for Ethereum over a custom period.
Detect sudden changes in social volume for an asset using a threshold.
Retrieve the top trending crypto words over a specific time window.
Measure how dominant a coin is in social media discussions.

FAQ from Crypto Sentiment MCP Server

What is the Santiment API key and where do I get it?

The server requires a Santiment API key. You can obtain a free or paid key from the Santiment platform at app.santiment.net.

What are the system requirements?

The server requires Python 3.10 or higher.

How do I configure the server in my MCP client?

Add the server to your client config with the command uv, arguments pointing to the repository directory and main.py, and set the SANTIMENT_API_KEY environment variable.

What data does this server use?

It uses aggregated social media and news data provided by Santiment to compute sentiment balances, social volumes, dominance, and trending words.

What tools does Crypto Sentiment MCP Server expose?

Five tools: get_sentiment_balance, get_social_volume, alert_social_shift, get_trending_words, and get_social_dominance. Each accepts parameters like asset name and time period.

Comments

More Finance & Commerce MCP servers

Binance MCP Server 🚀

AnalyticAce

Unofficial tools and server implementation for Binance's Model Context Protocol (MCP). Designed to support developers building crypto trading AI Agents.