Skip to main content

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 SettingsMCP 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-Agent header identifying it as sentisift-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

License

Proprietary. See project terms at sentisift.com/terms.html.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sentisift_mcp-0.1.3.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sentisift_mcp-0.1.3-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

File details

Details for the file sentisift_mcp-0.1.3.tar.gz.

File metadata

  • Download URL: sentisift_mcp-0.1.3.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for sentisift_mcp-0.1.3.tar.gz
Algorithm Hash digest
SHA256 45e0a50bdddd174efde4f9fbc5ecabc20ac1b062318388ef8ef3d36e22ee9fdf
MD5 510a3a6867d898a41d36bf56d2378e9a
BLAKE2b-256 e2d6b8340047128baec910e8dd5837482baf89680ec67e9ffe205610ed312b0f

See more details on using hashes here.

File details

Details for the file sentisift_mcp-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: sentisift_mcp-0.1.3-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

Hashes for sentisift_mcp-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 dad194b8d2d41db6b5d3ad9fa36a6d4ad8cf2a0b8eac97e0ce71c5345f1c8194
MD5 5a01517bf5874ba71485e53e11c85617
BLAKE2b-256 1fd179baee725fe0528e36bb6efb2a00a00f547a45aeee7cd12126b6f3fd04b8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page