Pionera brasileña en prevención de fraude (fundada en 2001). Score de riesgo de pedido, device fingerprinting, feedback de chargeback. Release alpha en npm — endpoints pendientes de validación contra el portal de desarrollador de ClearSale cerrado por contrato.
ClearSale le da a tu agente 18 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.
send_order_for_analysis — Submit an order to ClearSale for fraud analysis. Returns a score (0-100) and a decision (APROVADO / REPROVADO / EM_ANALISE). Include as much signal as possible — billing + shipping, IP, device, items, and payment — to improve the decision.get_order_analysis — Retrieve the current analysis state of an order previously sent to ClearSale. Useful when the initial response was EM_ANALISE and the decision is made asynchronously.update_order_status — Notify ClearSale of the merchant's final decision on an order (APROVADO / CANCELADO / DEVOLVIDO). This feeds the ML model and is required for accurate future decisions on the same buyer.// 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_order_for_analysis", { /* ... */ });$ npm install @codespar/mcp-clearsale@alphaAgregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).
{
"mcpServers": {
"clearsale": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-clearsale@alpha"
],
"env": {
"CLEARSALE_API_KEY": "<your_clearsale_api_key>"
}
}
}
}Después de reiniciar, tu agente puede llamar cualquiera de las 18 herramientas de abajo — probá send_order_for_analysis primero.
Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.
CLEARSALE_API_KEYClearSale API key / bearer token used in the Authorization header
CLEARSALE_BASE_URLClearSale API base URL. Defaults to https://api.clearsale.com.br (prod). Override per contract-issued staging URL.
Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.
send_order_for_analysisget_order_analysisupdate_order_statuslist_orderscreate_chargeback_notificationget_order_scorecreate_device_fingerprint_sessionget_device_fingerprintMCP es un protocolo — cualquier framework que lo hable puede montar este server.