@codespar/mcp-sift

MCP server for Sift — global enterprise ML-based fraud detection.

Third entry in the CodeSpar fraud category after @codespar/mcp-clearsale and @codespar/mcp-konduto. Sift is the global / enterprise counterpart to the two BR-native antifraud servers.

Positioning

	ClearSale	Konduto	Sift
Geography	Brazil	Brazil	Global (US-HQ, ~30 countries)
Founded	2001	2014	2011
Strength	Chargeback history db	Behavioral device intelligence	Multi-abuse-type ML + workflow decisions
Shape	Score + manual review	API-first, tight surface	Event stream in, scores + decisions out
Scope	Order fraud	Order fraud	Payment, account, content, promotion abuse

Also distinct from @codespar/mcp-jumio, which is global KYC / identity verification — a different layer than fraud scoring.

Sift's API shape

Sift is built around three APIs that work together:

1. Events API (/v205/events) — you POST every interesting signal (account creation, login, order, chargeback, ...) as a $-prefixed event.
2. Score API (/v205/users/{user_id}/score) — you GET the latest ML score for a user, or POST to force a rescore. Scores are floats in [0, 1] per abuse type (payment_abuse, account_abuse, content_abuse, promotion_abuse).
3. Decisions API v3 (/v3/accounts/{account_id}/...) — workflows in the Sift console turn scores into Decisions (block_user_payment_abuse, approve_order_payment_abuse, etc). You can apply a decision directly, read the current decisions on a user/order, or fetch the status of a workflow run.

Tools (20)

Tool	Purpose
send_event	Send a fraud signal to Sift's Events API (POST /v205/events).
get_user_score	Fetch the latest Sift score(s) for a user (GET /v205/users/{user_id}/score).
rescore_user	Force Sift to recompute a user's score right now (POST /v205/users/{user_id}/score).
label_user	Label a user as fraud or not-fraud via the legacy Labels API (POST /v205/users/{user_id}/labels).
unlabel_user	Remove any existing label on a user (DELETE /v205/users/{user_id}/labels).
apply_decision_to_user	Apply a workflow Decision to a user (POST /v3/accounts/{account_id}/users/{user_id}/decisions).
apply_decision_to_order	Apply a workflow Decision to a specific order (POST /v3/accounts/{account_id}/users/{user_id}/orders/{order...
get_user_decisions	Fetch the decisions currently applied to a user (GET /v3/accounts/{account_id}/users/{user_id}/decisions).
get_order_decisions	Fetch the decisions currently applied to an order (GET /v3/accounts/{account_id}/orders/{order_id}/decisions).
get_workflow_run	Fetch the status of a Sift Workflow run (GET /v3/accounts/{account_id}/workflows/runs/{run_id}).
send_chargeback	Send a $chargeback event to Sift's Events API (POST /v205/events).
send_login	Send a $login event to Sift's Events API (POST /v205/events).
send_logout	Send a $logout event to Sift's Events API (POST /v205/events).
send_content_status	Send a $content_status event to Sift's Events API (POST /v205/events).
link_session_to_user	Send a $link_session_to_user event to Sift's Events API (POST /v205/events).
send_custom_event	Send a custom (merchant-defined) event to Sift's Events API (POST /v205/events).
apply_decision_to_session	Apply a workflow Decision to a session (POST /v3/accounts/{account_id}/users/{user_id}/sessions/{session_id...
apply_decision_to_content	Apply a workflow Decision to a content item (POST /v3/accounts/{account_id}/users/{user_id}/content/{conten...
get_session_decisions	Fetch the decisions currently applied to a session (GET /v3/accounts/{account_id}/users/{user_id}/sessions/...
get_content_decisions	Fetch the decisions currently applied to a content item (GET /v3/accounts/{account_id}/users/{user_id}/cont...

Install

npm install @codespar/mcp-sift@alpha

Environment

SIFT_API_KEY="..."         # required, secret
SIFT_ACCOUNT_ID="..."      # required for all Decisions API v3 calls
SIFT_BASE_URL="..."        # optional; defaults to https://api.sift.com

Authentication

• Events API — $api_key is injected into the JSON body. The server handles this automatically.
• Score API + Decisions API v3 — HTTP Basic, API key as username, empty password. The server handles the base64 encoding.

Pass the raw key in SIFT_API_KEY.

Typical flow

1. Instrument your app: every signup, login, profile update, order, and chargeback becomes a send_event call with the right $type.
2. On high-stakes moments (checkout, withdrawal), call send_event with return_score: true to get an inline decision.
3. Or poll get_user_score / get_order_decisions asynchronously after a workflow run completes.
4. For manual review outcomes, call apply_decision_to_user or apply_decision_to_order with a Decision ID configured in the Sift console and source: "MANUAL_REVIEW".
5. When a chargeback is confirmed, send a $chargeback event AND either apply_decision_to_user with a Block decision or label_user with is_bad: true, abuse_type: "payment_abuse". Decisions are preferred for new integrations; Labels are kept for backward compatibility.

Alpha note

Shipped as 0.1.0-alpha.1. All endpoint paths are verified against Sift's official Ruby SDK (SiftScience/sift-ruby): rest_api_path, user_score_api_path, users_label_api_path, user_decisions_api_path, order_decisions_api_path, workflow_status_path, and the Decision ApplyTo path builder.

Scope vs. the original brief:

• Shipped & verified: send_event, get_user_score, rescore_user, label_user, unlabel_user, apply_decision_to_user, apply_decision_to_order, get_user_decisions, get_order_decisions, get_workflow_run.
• Dropped — not in the public SDK:
  • get_session_score (/v205/sessions/{session_id}/score) — no equivalent helper in the Ruby SDK; session-level scoring in Sift flows through session-level Decisions and Workflow runs, not a dedicated score endpoint.
  • list_workflow_runs (GET /v3/accounts/{account_id}/workflows/runs) — only GET /{run_id} is implemented in the public SDK. In practice, Sift surfaces run_ids in event responses rather than via a list endpoint.
  • get_psychology_score — no such endpoint in the public SDK.

The developers.sift.com reference pages gate deep-link URLs (403 on several paths), so we used the official SDK as the source of truth. Promote to 0.1.0 once a customer confirms (or denies) the dropped endpoints against the full Decisions / Score API reference in Sift's admin console.

Run

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-sift

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-sift

Category

fraud — third entry after ClearSale and Konduto. BR merchants operating internationally commonly pair Sift (global payment/account abuse) with ClearSale or Konduto (BR-specific chargeback history / device intelligence).

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT