Official Model Context Protocol (MCP) server for SentiSift. Lets Claude Desktop, Cursor, VS Code, Continue, and other MCP-compatible AI hosts call the SentiSift comment-moderation and intelligence API as a native tool.
Project description
SentiSift MCP Server
Official Model Context Protocol (MCP) server for SentiSift. Lets MCP-compatible AI hosts (Claude Desktop, Cursor, VS Code, Continue, and others) call the SentiSift comment-moderation and intelligence API as a native tool.
What this unlocks
Once installed, your AI assistant can:
- Analyze comments directly in conversation: "Run these 50 comments through SentiSift and show me the bots and the sentiment distribution."
- Check your account state: "What's my SentiSift balance and when does my subscription renew?"
- Retrieve historical results: "Show me the sentiment history for yesterday's article on example.com/breaking-news."
- Self-diagnose service status: "Is the SentiSift API ready, or are models still loading?"
No code required. The assistant calls the tools through MCP and reports back.
Tools exposed
| Tool | Description |
|---|---|
analyze_comments |
Submit a batch of comments plus an article URL, receive bot/spam flags, sentiment labels, commercial-content flags, moderation summary, and (on Pro/Enterprise) Intelligence + interleaved Influence comments. |
get_balance |
Current comment balance, tier, feature flags, active grants, subscription state, Influence stats. |
get_health |
Whether the SentiSift API is ready or still loading models. |
get_article_results |
Historical scored comments for an article URL (Pro/Enterprise retain full history; Free/Starter return buffer state only). |
Install
You need Python 3.10+ and a SentiSift API key. Free keys (1,000 comments, no credit card) at sentisift.com/pricing.
Recommended: uvx (zero install, always latest)
uv runs published Python apps without persistent install. This is the install-free path.
# One-time: install uv (mac/linux)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Verify it works (Ctrl-C after a few seconds; the server is meant to be
# launched by your AI host, not run in a terminal).
SENTISIFT_API_KEY=sk_sentisift_... uvx sentisift-mcp
Alternative: pip install
pip install sentisift-mcp
sentisift-mcp # run manually to verify
Host configuration
Each AI host has its own config file. Pick yours:
Claude Desktop
Edit the config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the SentiSift entry to mcpServers:
{
"mcpServers": {
"sentisift": {
"command": "uvx",
"args": ["sentisift-mcp"],
"env": {
"SENTISIFT_API_KEY": "sk_sentisift_your_key_here"
}
}
}
}
Restart Claude Desktop. You should see a new tool indicator in the bottom-left corner of a new chat. Try: "Use SentiSift to check my balance."
Cursor
Cursor supports MCP via the Settings → MCP Servers panel. Add:
- Name:
sentisift - Command:
uvx - Arguments:
sentisift-mcp - Environment variables:
SENTISIFT_API_KEY=sk_sentisift_your_key_here
Or edit ~/.cursor/mcp.json directly with the same structure as the Claude Desktop example above.
VS Code (with the MCP extension)
Edit your user or workspace settings.json:
{
"mcp.servers": {
"sentisift": {
"command": "uvx",
"args": ["sentisift-mcp"],
"env": {
"SENTISIFT_API_KEY": "sk_sentisift_your_key_here"
}
}
}
}
Continue.dev
In ~/.continue/config.json:
{
"mcpServers": [
{
"name": "sentisift",
"command": "uvx",
"args": ["sentisift-mcp"],
"env": {
"SENTISIFT_API_KEY": "sk_sentisift_your_key_here"
}
}
]
}
Any other MCP-compatible host
The server speaks MCP over stdio. Point your host at uvx sentisift-mcp (or sentisift-mcp if installed via pip) and set SENTISIFT_API_KEY in its environment.
How to talk to the assistant
Once configured, natural-language prompts work. Some examples:
"Check my SentiSift balance."
"Run these 20 comments through SentiSift for the article at https://example.com/breaking-story. Here are the comments:" (paste them)
"Is the SentiSift API ready right now, or is it still loading?"
"Fetch the processed comments for https://example.com/article-42 from SentiSift."
The assistant chooses the right tool, passes the right arguments, and summarizes the results. If a call fails, the error response includes a deep link to the relevant docs section so the assistant can self-correct.
Privacy
- The server sends a
User-Agentheader identifying it assentisift-mcp/<version>so we can distinguish MCP traffic from direct SDK traffic in our usage logs. No other telemetry. - The server runs locally on your machine. It only calls out to
api.sentisift.com. - Your API key stays on your machine (in the host's env config). It is never logged to disk by this server.
Source
Source and issue tracker: gitlab.com/pickel-fintech/sentisift-sdks.
Links
- SentiSift API docs
- OpenAPI spec
- Python SDK (this MCP server wraps it)
- Node SDK
- Changelog
- Support
License
Proprietary. See project terms at sentisift.com/terms.html.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sentisift_mcp-0.1.2.tar.gz.
File metadata
- Download URL: sentisift_mcp-0.1.2.tar.gz
- Upload date:
- Size: 8.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.2.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
145367b0cbc7bd1d36bdb6988ca32ab9eb8a42ab98e47b264f8b101ec52aa14b
|
|
| MD5 |
3f5925e526131922b59de354c0e6d407
|
|
| BLAKE2b-256 |
e3c88b21d490e2c42f4ef327935210ff074a47fdf212ef7f90f4ffcddd0123f3
|
File details
Details for the file sentisift_mcp-0.1.2-py3-none-any.whl.
File metadata
- Download URL: sentisift_mcp-0.1.2-py3-none-any.whl
- Upload date:
- Size: 9.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.2.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b6900d8d860445d5872bd444cab47503479e5f0f56ddedd1553aacbabe3f385
|
|
| MD5 |
20faed659609997e2cd4a5732c17d072
|
|
| BLAKE2b-256 |
6289505dc9287a2188f7efaf002148cbaa13b4ddb855afc426e279471cebc1dd
|