ClearSale

What your agent can do

ClearSale gives your agent 18 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →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", { /* ... */ });

Install

$ npm install @codespar/mcp-clearsale@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "clearsale": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-clearsale@alpha"
      ],
      "env": {
        "CLEARSALE_API_KEY": "<your_clearsale_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 18 tools below — try send_order_for_analysis first.

Environment variables · 2

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 18

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions