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.2.tar.gz (8.8 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.2-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

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

Hashes for sentisift_mcp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 145367b0cbc7bd1d36bdb6988ca32ab9eb8a42ab98e47b264f8b101ec52aa14b
MD5 3f5925e526131922b59de354c0e6d407
BLAKE2b-256 e3c88b21d490e2c42f4ef327935210ff074a47fdf212ef7f90f4ffcddd0123f3

See more details on using hashes here.

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

Hashes for sentisift_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4b6900d8d860445d5872bd444cab47503479e5f0f56ddedd1553aacbabe3f385
MD5 20faed659609997e2cd4a5732c17d072
BLAKE2b-256 6289505dc9287a2188f7efaf002148cbaa13b4ddb855afc426e279471cebc1dd

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