Konduto

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.

MIT · roda localmente ou pelo runtime da CodeSpar

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

Início rápido

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

Escolha seu cliente. O servidor roda localmente via stdio, ou pelo runtime hospedado.

Ferramentas

O que o seu agente pode chamar.

Submit an order to Konduto for fraud analysis. Returns a decision (approved / declined / review / not_analyzed), a numeric score, and a recommendation. Include as much signal as possible — billing + shipping, ip, items, payment, and (crucially) the visitor id captured by Konduto's browser JS SDK — to maximize decision quality.

Retrieve the current analysis state of an order. Returns decision (approved / declined / review / not_analyzed), numeric score, and recommendation. Useful when the initial response was 'review' or when polling after async re-scoring.

Notify Konduto of the merchant's final status for an order. Feeds Konduto's ML model and is required for ongoing decision quality. Common transitions: new → approved, new → declined, approved → canceled, approved → fraud (when a chargeback is confirmed).

Report a confirmed chargeback for an order. Convenience wrapper around update_order_status with status='fraud' — the primary feedback signal Konduto's ML model uses to retrain on similar buyers. Call this as soon as the chargeback dispute is confirmed (not when first received).

Report that an order was ultimately approved by the merchant. Convenience wrapper around update_order_status with status='approved'. Use after Konduto returned 'review' and a human approved the order, or when the merchant overrode a 'declined' recommendation.

Report that an order was ultimately declined by the merchant. Convenience wrapper around update_order_status with status='declined'. Use after manual review concluded the order should be rejected, or when the acquirer declined the payment.

Add a value to the Konduto blocklist. Any future order matching the value is auto-declined. Useful for known-bad emails, IPs, tax IDs, or card BIN+last4 pairs observed in confirmed fraud.

Check whether a value is currently on the Konduto blocklist.

Update an existing blocklist entry — typically used to extend or shorten the expiration window (expires_at) without removing and re-adding the entry. The (type, value) pair must already exist on the blocklist.

Remove a value from the Konduto blocklist.

Add a value to the Konduto allowlist (trusted). Future orders matching the value are auto-approved without full ML scoring. Use sparingly — allowlist overrides fraud signals.

Check whether a value is currently on the Konduto allowlist. Konduto's public docs explicitly support email; other dimensions are accepted by symmetry with the blocklist contract but only email is guaranteed.

Compatibilidade

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

Pelo runtime da CodeSpar, o codespar_discover encontra as ferramentas deste servidor, e um tools/call roda com a credencial conectada no seu projeto, inclusive com chave de teste.

Comece em segundos.

No runtime da CodeSpar, a credencial que você conecta fica criptografada para a sua organização e o runtime a coloca em cada chamada. Você só chama a ferramenta.