Clearsale MCP Server - install, status & alternatives [2026]

01 · Install Clearsale

before you install - you'll need

Set CLEARSALE_API_KEY, MCP_HTTP before connecting. CLEARSALE_BASE_URL is optional or environment-specific per the README.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-fraud-cl -- npx -y @codespar/mcp-clearsale

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-fraud-cl": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-clearsale"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-clearsale - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Clearsale can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can retrieve the current analysis state of an order previously sent to ClearSale, list orders submitted to ClearSale with optional filters, report a confirmed chargeback back to ClearSale, and fetch only the fraud score (numeric 0-100) for an order.

Capability map

Tools grouped from the project's README - what Clearsale lets an agent do.

Order

4 tools - e.g. Submit an order to ClearSale for fraud analysis.; Retrieve the current analysis state of an order previously sent to ClearSale.; Notify ClearSale of the merchant's final decision on an order (APROVADO /…

send_order_for_analysis · get_order_analysis · update_order_status · get_order_score

Validate

3 tools - e.g. KYC: validate a CPF or CNPJ against Receita Federal.; KYC: validate a Brazilian postal address against the Correios database.; Verify a buyer's response to a challenge issued via issue_challenge.

validate_document · validate_address · validate_challenge_response

Device

2 tools - e.g. Start a device fingerprint session.; Retrieve captured device characteristics for a fingerprint session (OS, browser, timezone, canvas/WebGL has...

create_device_fingerprint_session · get_device_fingerprint

Score

2 tools - e.g. Look up the risk score and historical signals associated with a Brazilian document (CPF or CNPJ).; Look up the risk score for a contact identifier (email or phone).

get_score_by_document · get_score_by_contact

Case

2 tools - e.g. Open a fraud investigation case (e.g.; Update an existing fraud investigation case - change status, add notes, reassign, or attach more orders.

create_case · update_case

read & search

1 tool - e.g. List orders submitted to ClearSale with optional filters.

list_orders

create & write

1 tool - e.g. Report a confirmed chargeback back to ClearSale.

create_chargeback_notification

Resolve

1 tool - e.g. Manually resolve an order currently in EM_ANALISE by approving or declining it.

resolve_manual_review

04 · Who maintains Clearsale

mcp-clearsale is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: other - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-clearsale (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-clearsale

06 · Clearsale FAQ

Is Clearsale still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Clearsale do?

With this server connected, an agent can retrieve the current analysis state of an order previously sent to ClearSale, list orders submitted to ClearSale with optional filters, report a confirmed chargeback back to ClearSale, and fetch only the fraud score (numeric 0-100) for an order.

How do I install Clearsale?

Run `npx -y @codespar/mcp-clearsale`. The README documents 3 environment variables (CLEARSALE_API_KEY, CLEARSALE_BASE_URL, MCP_HTTP) to set first. Set CLEARSALE_API_KEY, MCP_HTTP before connecting. CLEARSALE_BASE_URL is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Clearsale run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Clearsale

Alternatives to Clearsale

Maintained other servers if Clearsale isn't the fit.

More MCP servers to compare · Konduto · Legiti · Sift · Bigdatacorp · Certta

More JavaScript MCP servers · Brasil API · see all