{"name":"io.github.codespar/mcp-clearsale","slug":"codespar-mcp-clearsale","title":null,"description":"MCP server for ClearSale — Brazilian fraud prevention, order risk scoring, device fingerprinting","url":"https://mcp.market/server/codespar-mcp-clearsale","rating":null,"grade":"B","score":82,"certified":false,"status":"active","category":"ecommerce","tags":["ecommerce"],"presence":{"score":38,"stars":271,"forks":50,"downloads_week":null,"last_push_at":"2026-08-29T02:02:48.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/codespar/mcp-dev-latam","website":null,"version":"0.2.0-alpha.3","remotes":[],"packages":[{"registryType":"npm","identifier":"@codespar/mcp-clearsale","version":"0.2.0-alpha.3","transport":{"type":"stdio"},"environmentVariables":[{"description":"ClearSale API key / bearer token used in the Authorization header","isRequired":true,"format":"string","isSecret":true,"name":"CLEARSALE_API_KEY"},{"description":"ClearSale API base URL. Defaults to https://api.clearsale.com.br (prod). Override per contract-issued staging URL.","format":"string","name":"CLEARSALE_BASE_URL"}]}],"tools":[{"name":"create_case","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_chargeback_notification","description":"Report a confirmed chargeback back to ClearSale. Critical for model tuning: unreported chargebacks degrade future decision quality for similar buyers.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_device_fingerprint_session","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_device_fingerprint","description":"Retrieve captured device characteristics for a fingerprint session (OS, browser, timezone, canvas/WebGL hash, suspected emulator, etc).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_order_analysis","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_order_score","description":"Fetch only the fraud score (numeric 0-100) for an order. Lighter than get_order_analysis when the full decision envelope isn't needed.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_score_by_contact","description":"Look up the risk score for a contact identifier (email or phone). Use for account-takeover screening at login or password reset.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_score_by_document","description":"Look up the risk score and historical signals associated with a Brazilian document (CPF or CNPJ). Use for pre-checkout screening or onboarding.","write_action":false,"price_micros":0,"input_schema":null},{"name":"issue_challenge","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_orders","description":"List orders submitted to ClearSale with optional filters. Use for dashboards, reconciliation, and reviewing pending manual decisions.","write_action":false,"price_micros":0,"input_schema":null},{"name":"resolve_manual_review","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"send_order_for_analysis","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"track_behavior_event","description":"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.","write_action":false,"price_micros":0,"input_schema":null},{"name":"update_case","description":"Update an existing fraud investigation case — change status, add notes, reassign, or attach more orders.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_order_status","description":"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.","write_action":true,"price_micros":0,"input_schema":null},{"name":"validate_address","description":"KYC: validate a Brazilian postal address against the Correios database. Confirms zip_code → street/neighborhood/city/state and flags mismatches.","write_action":false,"price_micros":0,"input_schema":null},{"name":"validate_challenge_response","description":"Verify a buyer's response to a challenge issued via issue_challenge. Returns whether the response is valid and how many attempts remain.","write_action":false,"price_micros":0,"input_schema":null},{"name":"validate_document","description":"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.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":82,"grade":"B","scanned_at":"2026-09-26T21:19:14.573Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-26T21:19:14.502Z","components":{"code":{"score":25,"max":25,"notes":["6 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 29 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@codespar/mcp-clearsale","version":"0.2.0-alpha.3","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":1,"publishedAt":"2026-06-22T18:40:57.463Z"}],"repo":{"found":true,"owner":"codespar","repo":"mcp-dev-latam","archived":false,"pushedAt":"2026-08-29T02:02:48Z","stars":271,"forks":50,"openIssues":10,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/269058982?v=4","ownerCreatedAt":"2026-03-18T00:40:56Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/269058982?v=4&s=128","source":"github"},"presence":{"stars":271,"forks":50,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-08-29T02:02:48.000Z","score":38}}}},"grade_history":[],"reviews":[]}