Sift

What your agent can do

Sift gives your agent 20 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →send_event — Send a fraud signal to Sift's Events API (POST /v205/events). The `type` parameter selects the event kind ($create_order, $transaction, $login, $create_account, $update_account, $chargeback, $order_status, etc). Additional fields ($user_id, $session_id, $order_id, custom fields) are passed via `fields` and merged into the body. Use `return_score=true` to get a synchronous score in the response.
• →get_user_score — Fetch the latest Sift score(s) for a user (GET /v205/users/{user_id}/score). Does NOT trigger a rescore — it returns whatever score was last computed. The score is a float in [0, 1]; higher means more fraud-like. Optionally filter by abuse_types.
• →rescore_user — Force Sift to recompute a user's score right now (POST /v205/users/{user_id}/score). Use when you have externally-observed signal that should invalidate the last score (e.g. a manual decision) but have not sent a new event.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("send_event", { /* ... */ });

Install

$ npm install @codespar/mcp-sift@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "sift": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-sift@alpha"
      ],
      "env": {
        "SIFT_API_KEY": "<your_sift_api_key>",
        "SIFT_ACCOUNT_ID": "<your_sift_account_id>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try send_event first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions