{"_id":"@codespar/mcp-clearsale","_rev":"5-9550bd408ab4d586b326c845e22c475e","name":"@codespar/mcp-clearsale","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0-alpha.1":{"name":"@codespar/mcp-clearsale","version":"0.1.0-alpha.1","keywords":["mcp","clearsale","fraud","fraud-prevention","risk-scoring","chargeback","device-fingerprint","antifraud","brazil","ecommerce"],"license":"MIT","_id":"@codespar/mcp-clearsale@0.1.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-clearsale":"dist/index.js"},"dist":{"shasum":"9845fc76b5bd8e00a75aeb2f447daf52a9cac1f0","tarball":"https://registry.npmjs.org/@codespar/mcp-clearsale/-/mcp-clearsale-0.1.0-alpha.1.tgz","fileCount":7,"integrity":"sha512-NZaR2J8EygyP/Ym10MtrAtTXrBJa9oNcud7g7lcrRQ6ydAyUP0vL9KreUKR9LLiFSG/clcdhL/Y44z/vVuHWsw==","signatures":[{"sig":"MEYCIQCLQATkkKzKi8QR3PBlw/8MS3sbd6s0ymiQyScLk2S7lAIhAJxT9khom2SUDwMI82TKwCmXZuNnA+ZlFvNpq6dTkgXw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39317},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"c00634d3cb84e72668261708b2a55e90bf9ae780","mcpName":"io.github.codespar/mcp-clearsale","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for ClearSale — Brazilian fraud prevention, order risk scoring, device fingerprinting, and chargeback feedback","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-clearsale_0.1.0-alpha.1_1776992566208_0.8899242070757172","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-clearsale","version":"0.2.0-alpha.1","keywords":["mcp","clearsale","fraud","fraud-prevention","risk-scoring","chargeback","device-fingerprint","antifraud","brazil","ecommerce"],"license":"MIT","_id":"@codespar/mcp-clearsale@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-clearsale":"dist/index.js"},"dist":{"shasum":"d1e5612968de908a65e83e04ae5e8589787ddebf","tarball":"https://registry.npmjs.org/@codespar/mcp-clearsale/-/mcp-clearsale-0.2.0-alpha.1.tgz","fileCount":7,"integrity":"sha512-pWUF5szicvLT9RuYJCUOwCHDRmI8KA1J10tCYlc1JPv2SVXXBL0BLemY2FlUcaOsXYWCOPRfpKAg980yqiB3Dw==","signatures":[{"sig":"MEYCIQCWr0+lMjTaKTVsiWbcF9902j9x0GLsfciJEyQTPmoGugIhANpydJ/y6dbdL0s4T8y4hhjScCIbqA3SW8uytET5iOKz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64922},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a9ff36701206eb6feb7fffffc4cbb2a325757082","mcpName":"io.github.codespar/mcp-clearsale","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for ClearSale — Brazilian fraud prevention, order risk scoring, device fingerprinting, and chargeback feedback","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-clearsale_0.2.0-alpha.1_1777115941435_0.31299486215978467","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-clearsale","version":"0.2.0-alpha.2","keywords":["mcp","clearsale","fraud","fraud-prevention","risk-scoring","chargeback","device-fingerprint","antifraud","brazil","ecommerce"],"license":"MIT","_id":"@codespar/mcp-clearsale@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-clearsale":"dist/index.js"},"dist":{"shasum":"6482527e51b90ac1f50fb98a120809dee90e9e50","tarball":"https://registry.npmjs.org/@codespar/mcp-clearsale/-/mcp-clearsale-0.2.0-alpha.2.tgz","fileCount":7,"integrity":"sha512-5OYfaBqOxyySNQkB5atKy4/ubhH6ixMV2T0fkCdoF0aX8SsD8H9X7uM20eKSAmPng/9Zrm/Vf6aKknmfZyf3nw==","signatures":[{"sig":"MEUCIQDazIF/uX+CzGyYjPzXyNWneJXBfmkJU0A6NgwOaJJXPwIgWyx5n0nl5S2Dir51pcEKunZcs30z7zK3nJ6aEqgyLCM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":66070},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-clearsale","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for ClearSale — Brazilian fraud prevention, order risk scoring, device fingerprinting, and chargeback feedback","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-clearsale_0.2.0-alpha.2_1777123094633_0.16156650850699683","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-clearsale","version":"0.2.0-alpha.3","description":"MCP server for ClearSale — Brazilian fraud prevention, order risk scoring, device fingerprinting, and chargeback feedback","type":"module","main":"./dist/index.js","bin":{"mcp-clearsale":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","clearsale","fraud","fraud-prevention","risk-scoring","chargeback","device-fingerprint","antifraud","brazil","ecommerce"],"mcpName":"io.github.codespar/mcp-clearsale","_id":"@codespar/mcp-clearsale@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-DbrrV5Q33TkdSICvQB9CSIoSiLojmi2Yt70GA/s5b2LO8FyJWbZEAiNeHLYbbYNhiMbaWAMcNglvsfQDVI3/EA==","shasum":"93dddf27ea1a704bccea2b57a4bb04c4b1da63c2","tarball":"https://registry.npmjs.org/@codespar/mcp-clearsale/-/mcp-clearsale-0.2.0-alpha.3.tgz","fileCount":7,"unpackedSize":67543,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBLUXi30+aL9cwP05xbG01y5FJikS0oyQA2rbDbHGSYCAiAR2JrFBtJ5lYFBMnoUOU2Pci9Eq8uDS8L7uWdLoy+8JQ=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-clearsale_0.2.0-alpha.3_1782153657310_0.9948687656168931"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T01:02:46.130Z","modified":"2026-06-22T18:40:57.602Z","0.1.0-alpha.1":"2026-04-24T01:02:46.368Z","0.2.0-alpha.1":"2026-04-25T11:19:01.586Z","0.2.0-alpha.2":"2026-04-25T13:18:14.791Z","0.2.0-alpha.3":"2026-06-22T18:40:57.463Z"},"license":"MIT","keywords":["mcp","clearsale","fraud","fraud-prevention","risk-scoring","chargeback","device-fingerprint","antifraud","brazil","ecommerce"],"description":"MCP server for ClearSale — Brazilian fraud prevention, order risk scoring, device fingerprinting, and chargeback feedback","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-clearsale\n\nMCP server for [ClearSale](https://clearsale.com.br) — Brazilian fraud prevention.\n\nClearSale pioneered fraud analytics in Brazil (founded 2001, São Paulo) and remains the default antifraud layer for most major BR ecommerce. This is the first entry in the CodeSpar `fraud` category — no other server in the catalog does fraud scoring. Future entries (Konduto, Legiti, Sift, Cybersource) will follow the same analyze → decide → feedback shape.\n\n## Tools (18)\n\n| Tool | Purpose |\n|---|---|\n| `send_order_for_analysis` | Submit an order to ClearSale for fraud analysis. |\n| `get_order_analysis` | Retrieve the current analysis state of an order previously sent to ClearSale. |\n| `update_order_status` | Notify ClearSale of the merchant's final decision on an order (APROVADO / CANCELADO / DEVOLVIDO). |\n| `list_orders` | List orders submitted to ClearSale with optional filters. |\n| `create_chargeback_notification` | Report a confirmed chargeback back to ClearSale. |\n| `get_order_score` | Fetch only the fraud score (numeric 0-100) for an order. |\n| `create_device_fingerprint_session` | Start a device fingerprint session. |\n| `get_device_fingerprint` | Retrieve captured device characteristics for a fingerprint session (OS, browser, timezone, canvas/WebGL has... |\n| `resolve_manual_review` | Manually resolve an order currently in EM_ANALISE by approving or declining it. |\n| `get_score_by_document` | Look up the risk score and historical signals associated with a Brazilian document (CPF or CNPJ). |\n| `get_score_by_contact` | Look up the risk score for a contact identifier (email or phone). |\n| `validate_document` | KYC: validate a CPF or CNPJ against Receita Federal. |\n| `validate_address` | KYC: validate a Brazilian postal address against the Correios database. |\n| `track_behavior_event` | Log a behavior signal (page view, login, signup, custom event) tied to a fingerprint session. |\n| `issue_challenge` | Issue an authentication challenge (OTP via SMS/email or KBA question) to a buyer. |\n| `validate_challenge_response` | Verify a buyer's response to a challenge issued via issue_challenge. |\n| `create_case` | Open a fraud investigation case (e.g. |\n| `update_case` | Update an existing fraud investigation case — change status, add notes, reassign, or attach more orders. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-clearsale@alpha\n```\n\n## Environment\n\n```bash\nCLEARSALE_API_KEY=\"...\"    # Bearer token issued by ClearSale\nCLEARSALE_BASE_URL=\"...\"   # Optional. Defaults to https://api.clearsale.com.br. Override per contract-issued staging URL.\n```\n\n## Authentication\n\nServer-side Bearer token:\n\n```\nAuthorization: Bearer <CLEARSALE_API_KEY>\n```\n\nClearSale issues the token via the developer portal or through your commercial contract. There is no public sandbox — staging URLs are provisioned per contract; override `CLEARSALE_BASE_URL` to point at it.\n\n## Typical flow\n\n1. On page load, the merchant calls `create_device_fingerprint_session` and embeds ClearSale's browser JS using the returned `session_token`.\n2. At checkout, the merchant calls `send_order_for_analysis` with the same `session_id` plus full order, payment, items, and billing/shipping data.\n3. The response carries a decision: `APROVADO` (ship it), `REPROVADO` (block), or `EM_ANALISE` (poll `get_order_analysis` or wait for a webhook).\n4. Once the order lifecycle completes, call `update_order_status` with the final merchant decision — this is required for ongoing model quality.\n5. If a chargeback arrives later, call `create_chargeback_notification` so ClearSale can tune its model.\n\n## Run\n\n```bash\n# stdio (default — for Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-clearsale\n\n# HTTP (for server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-clearsale\n```\n\n## Category\n\n`fraud` — first server in this CodeSpar category. Fraud servers share a common shape (analyze → decide → feedback) distinct from payments, which makes cross-provider swaps (ClearSale ↔ Konduto ↔ Legiti) more straightforward than cross-acquirer swaps.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}