MCP.Market

Clearsale MCP server

by codespar·io.github.codespar/mcp-clearsale·v0.2.0-alpha.3·271 stars
No reviews yet

MCP server for ClearSale — Brazilian fraud prevention, order risk scoring, device fingerprinting

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Growing

271 stars

Reviews

Write one

Nobody has reviewed Clearsale yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Clearsale tools (18, 8 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • create_casewrite action

    Open a fraud investigation case (e.g. for a suspicious cluster of orders or a confirmed fraud ring). Cases group orders, evidence, and analyst notes.

  • create_chargeback_notificationwrite action

    Report a confirmed chargeback back to ClearSale. Critical for model tuning: unreported chargebacks degrade future decision quality for similar buyers.

  • create_device_fingerprint_sessionwrite action

    Start a device fingerprint session. Returns a session_token the client embeds via ClearSale's browser JS SDK to capture device characteristics. Pass the same session_id into send_order_for_analysis to link the device to the order.

  • get_device_fingerprint

    Retrieve captured device characteristics for a fingerprint session (OS, browser, timezone, canvas/WebGL hash, suspected emulator, etc).

  • get_order_analysiswrite action

    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.

  • get_order_scorewrite action

    Fetch only the fraud score (numeric 0-100) for an order. Lighter than get_order_analysis when the full decision envelope isn't needed.

  • get_score_by_contact

    Look up the risk score for a contact identifier (email or phone). Use for account-takeover screening at login or password reset.

  • get_score_by_document

    Look up the risk score and historical signals associated with a Brazilian document (CPF or CNPJ). Use for pre-checkout screening or onboarding.

  • issue_challenge

    Issue an authentication challenge (OTP via SMS/email or KBA question) to a buyer. Use as a step-up after EM_ANALISE or for high-risk flows.

  • list_orders

    List orders submitted to ClearSale with optional filters. Use for dashboards, reconciliation, and reviewing pending manual decisions.

  • resolve_manual_review

    Manually resolve an order currently in EM_ANALISE by approving or declining it. Use when an analyst overrides ClearSale's pending decision. The decision is fed back into the model.

  • send_order_for_analysiswrite action

    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.

  • track_behavior_event

    Log a behavior signal (page view, login, signup, custom event) tied to a fingerprint session. Behavior data sharpens decisions on subsequent send_order_for_analysis calls.

  • update_casewrite action

    Update an existing fraud investigation case — change status, add notes, reassign, or attach more orders.

  • update_order_statuswrite action

    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.

  • validate_address

    KYC: validate a Brazilian postal address against the Correios database. Confirms zip_code → street/neighborhood/city/state and flags mismatches.

  • validate_challenge_response

    Verify a buyer's response to a challenge issued via issue_challenge. Returns whether the response is valid and how many attempts remain.

  • validate_document

    KYC: validate a CPF or CNPJ against Receita Federal. Returns registration status (REGULAR / SUSPENSA / CANCELADA / NULA / PENDENTE) and, when authorized, holder name and birth date.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan6 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 29 days ago15/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Clearsale compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 75% of 2,174 E-commerce servers
Tools
18
the typical E-commerce server has 6
Tools that change things
44%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
271
more than 95% of 1,047 E-commerce servers

What its tools let an agent do: 10 read · 3 create · 4 change · 1 send or post

Install Clearsale in Claude Code, Cursor or VS Code

Runs npx -y @codespar/mcp-clearsale on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-clearsale -- npx -y @codespar/mcp-clearsale
Add to Cursor

What the publisher says

From the Clearsale repository's README, as published. We do not edit it. Read it on GitHub

MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute

The Problem

AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).

Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.

MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.

The Solution

Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

Six systems. Zero human intervention. One agent.

Agentic Payment Protocols

Four servers for the emerging agentic payment stack:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Clearsale: common questions

Is Clearsale MCP server safe?
Mostly: it is graded B (82/100). Read the Clearsale safety report
How do I install Clearsale?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Clearsale need an API key?
Yes. The registry entry asks for CLEARSALE_API_KEY.
Is Clearsale maintained?
The last commit was 67 days ago (2026-08-29). The latest release is v0.2.0-alpha.3.
What can I use instead of Clearsale?
Servers from other publishers that do the same job: Finance MCP server, Polymarket Toolkit MCP server and Sv Number MCP server.
How does Clearsale compare with other E-commerce MCP servers?
safety score 82/100 (higher than 75% of 2,174 E-commerce servers); tools 18 (the typical E-commerce server has 6); tools that change things 44% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Clearsale

Same job from other publishers: the closest match first, then the best rated.

  • Finance MCP
    Market data, SEC filings and risk tools for Webull, Saxo and IBKR. Only you can send an order.
    B
  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B
  • Sv Number
    Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back.
    B
  • WebCake Storefront
    Build pages and manage products, orders, and content on the WebCake/StoreCake storefront builder.
    A
  • Shopware
    Query and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.
    B

More from codespar →