Skip to main content
S

Sift

@codespar/mcp-sift · v0.2.0-alpha.3

🌐 GlobalFraude e riscoAuth · API Keybeta20 ferramentas3 variáveis de ambienteversão prévia

Detecção de fraude global baseada em ML — eventos + scores + decisões + feedback de labels. Alpha no npm — paths verificados contra o SDK SiftScience/sift-ruby.

Comece · grátisVer docs

MIT · roda localmente com as suas credenciais

Variáveis de ambiente, nomes e descrições das ferramentas vêm do pacote npm e ficam em inglês.

Limitações

  • A v0.2.0-alpha.3 é uma versão prévia; o npm não tem versão estável deste pacote.
  • Chamadas hospedadas com chave de teste não estão disponíveis: o runtime não registrou o comportamento deste provedor em teste (test venue unclassified).
Pacote
@codespar/mcp-sift
Versão
0.2.0-alpha.3 · versão prévia
dist-tag npm
latest
Categoria
Fraude e risco
Auth
API Key
País
🌐 Global
Licença
MIT
Transporte
stdio · streamable-http

Início rápido

Instale, configure as credenciais, faça a primeira chamada.

Escolha seu cliente. O servidor roda localmente via stdio, com as suas credenciais.

Adicione o servidor ao seu clienteUma entrada de configuração. Sem build, sem SDK.
Defina as variáveis de ambiente3 variáveis lidas pelo código deste servidor, listadas abaixo.
Reinicie e faça a primeira chamadaO agente pode chamar qualquer uma das 20 ferramentas. Comece por send_event.
terminal
# Claude Code claude mcp add sift -e SIFT_ACCOUNT_ID=… -e SIFT_API_KEY=… -e SIFT_BASE_URL=… -- npx -y @codespar/mcp-sift@0.2.0-alpha.3 # then: /mcp to confirm the server is connected
Variáveis de ambiente3 variáveis
SIFT_ACCOUNT_IDSift Account ID. Required for all Decisions API v3 endpoints (path segment /v3/accounts/{account_id}/...).obrigatória
SIFT_API_KEYSift API key. Used in the Events API request body ($api_key) and as the HTTP Basic auth username (empty password) for Score + Decisions APIs.obrigatóriasegredo
SIFT_BASE_URLSift API base URL. Defaults to https://api.sift.com.opcional

Nomes lidos do código do pacote (@codespar/mcp-sift@0.2.0-alpha.3). Descrições e marcações vêm do manifesto dele. Auto-hospedado, você guarda as credenciais.

Primeira chamada demosend_event

"Send a fraud signal to Sift's Events API"

tools/callsend_eventresultado devolvido

Ferramentas

O que o seu agente pode chamar.

20 ferramentas, como o tools/list do pacote as devolve.

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.

label_user

Label a user as fraud or not-fraud via the legacy Labels API (POST /v205/users/{user_id}/labels). Labels are the classic supervised-learning feedback channel for Sift's ML model. Note: most new integrations use the Decisions API (apply_decision_to_user) instead — labels are kept for backward compatibility. Still supported for ongoing model feedback.

unlabel_user

Remove any existing label on a user (DELETE /v205/users/{user_id}/labels). Optionally scope by abuse_type.

apply_decision_to_user

Apply a workflow Decision to a user (POST /v3/accounts/{account_id}/users/{user_id}/decisions). Decisions are the modern replacement for Labels — they both classify the entity for Sift's ML and trigger any configured side effects (e.g. a Block decision on a $payment_abuse user will cause that user's future $transaction events to be blocked). Requires SIFT_ACCOUNT_ID.

apply_decision_to_order

Apply a workflow Decision to a specific order (POST /v3/accounts/{account_id}/users/{user_id}/orders/{order_id}/decisions). Order-level decisions target a single transaction rather than the whole user (e.g. 'approve_order_payment_abuse' on a manually-reviewed high-value order). Requires SIFT_ACCOUNT_ID.

get_user_decisions

Fetch the decisions currently applied to a user (GET /v3/accounts/{account_id}/users/{user_id}/decisions). Returns the active decision per abuse type. Requires SIFT_ACCOUNT_ID.

get_order_decisions

Fetch the decisions currently applied to an order (GET /v3/accounts/{account_id}/orders/{order_id}/decisions). Note: the order-level GET path does NOT include user_id, unlike the order-level apply path. Requires SIFT_ACCOUNT_ID.

get_workflow_run

Fetch the status of a Sift Workflow run (GET /v3/accounts/{account_id}/workflows/runs/{run_id}). The run_id is returned in the response to events sent with return_workflow_status=true. The run status tells you which route of the workflow was taken and which decisions were applied. Requires SIFT_ACCOUNT_ID.

send_chargeback

Send a $chargeback event to Sift's Events API (POST /v205/events). Convenience wrapper around send_event for the most common ML-feedback signal: a confirmed chargeback. Sift uses chargeback events as a strong negative-label signal for the payment_abuse model. Optionally request a synchronous score with return_score=true.

send_login

Send a $login event to Sift's Events API (POST /v205/events). Convenience wrapper for tracking login attempts — both successful and failed attempts feed Sift's account_abuse model.

Nomes e descrições vêm do tools/list do pacote (@codespar/mcp-sift@0.2.0-alpha.3). Um tipo (leitura, escrita, exclusão) só aparece quando o pacote anota suas ferramentas ou cada ferramenta foi verificada uma a uma; nenhum dos dois existe ainda para este servidor.

Compatibilidade

MCP é um protocolo. Qualquer cliente que o fale pode montar este servidor.

O codespar_discover lista as ferramentas deste servidor, mas um projeto com chave de teste ainda não consegue chamá-las: o runtime não registrou o que este provedor faz em modo de teste e recusa em vez de adivinhar.

Protocolo

Qualquer cliente MCP

stdio · streamable-http

Perguntas

Antes de instalar.

Como instalo o servidor MCP Sift?

Rode npx -y @codespar/mcp-sift@0.2.0-alpha.3 e adicione o bloco de configuração acima ao seu cliente MCP: Claude Code, Cursor, Claude Desktop, VS Code ou qualquer cliente compatível. Sem build, sem SDK.

O que meu agente pode fazer com Sift?

Sift expõe 20 ferramentas de fraude e risco. Seu agente as chama diretamente; a lista completa está acima.

Como Sift autentica, e como as credenciais são guardadas?

Sift usa API Key. Auto-hospedado, você guarda as credenciais: o servidor as lê das variáveis de ambiente.

Como Sift lida com mudanças na API do provedor?

Cada servidor tem versão própria no npm. O comando desta página fixa a 0.2.0-alpha.3, a versão cujas ferramentas estão listadas aqui; seu agente segue nela até você trocar a versão.

Sift é open source? Como reporto um bug?

Sim. Sift tem licença MIT e está publicado no npm como @codespar/mcp-sift, com o código no GitHub (link no painel Detalhes). Reporte problemas no repositório do pacote; problemas de segurança vão para security@codespar.dev, e respondemos em até 24 horas.

Combina com

Fraude e risco · mesma categoria.

C

ClearSale

@codespar/mcp-clearsale · 18 ferramentas

Pioneira brasileira em prevenção a fraudes (fundada em 2001). Score de risco de pedido, device fingerprinting, feedback de chargeback. Release alpha no npm — endpoints pendentes de validação contra o portal de desenvolvedor da ClearSale fechado por contrato.

Abrir
K

Konduto

@codespar/mcp-konduto · 18 ferramentas

Analytics de fraude do BR — mais API-first que a ClearSale. Análise de pedido, gestão de blocklist/allowlist/review-list, feedback de chargeback via updates de status. Combine com a ClearSale pra comparação de score ou failover. Alpha no npm — 3 endpoints breves não estão nas docs públicas; core verificado contra docs.konduto.com.

Abrir
L

Legiti

@codespar/mcp-legiti · 18 ferramentas

Prevenção a fraudes nativa de ticketing do BR (antiga Inspetor, São Paulo). 4ª entrada de fraude. Avaliação de pedido + Collection API pra rastreamento de eventos/contas/auth. Alpha no npm — docs públicas mais finas que ClearSale/Konduto; os formatos das tools batem com o repo docs-backend.

Abrir

Comece em segundos.

Adicione a configuração acima, defina as variáveis, e seu agente chama as ferramentas.

Comece em segundos demo
Adicione o servidor ao seu cliente com a configuração acima.
Defina as variáveis de ambiente listadas acima.
Peça ao seu agente a primeira chamada.
Sift — MCP server · 20 tools | CodeSpar