# ClearSale MCP for AI Agents MCP

> ClearSale connects your AI agent directly to e-commerce fraud prevention tools. Submit orders for instant risk scoring, review full analysis histories, and update order statuses—all within a natural chat conversation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** fraud-prevention, transaction-analysis, order-scoring, risk-management, chargeback-protection

## Description

Managing e-commerce fraud used to mean bouncing between dashboards, spreadsheets, and internal ticketing systems just to get a clear answer on one order. This MCP changes that. You connect your ClearSale account to any AI agent and take full control of the entire fraud prevention process through simple conversation. Instead of manually looking up data, you ask your agent questions about transaction risks, review which orders need attention, or check an order's current status without leaving your chat interface. This connectivity lets you analyze complex transaction histories and even update statuses directly in ClearSale’s system. All this capability is managed through the Vinkius catalog, giving your AI client a single point of access to critical financial data.

## Tools

### get_clearsale_account_info
Retrieves necessary core account connectivity details for verification.

### get_order_fraud_status
Checks the current fraud analysis status for a specific order ID.

### list_recent_fraud_analyses
Provides a list and overview of orders analyzed for potential fraud in recent history.

### submit_order_fraud_analysis
Submits an order's details to the system, triggering real-time fraud analysis scoring.

### update_clearsale_order_status
Changes the official status of an order within ClearSale (e.g., Approved or Cancelled).

## Prompt Examples

**Prompt:** 
```
Can you check the risk and status for order #ped_12345?
```

**Response:** 
```
**Fraud Analysis Report for ped_12345**

*   **Current Status:** Approved (ACTIVE)
*   **Risk Score:** 15/100 (Low Risk)
*   **Analysis Date:** Today, 10:15 AM

No further manual action is required. The order can proceed to fulfillment.
```

**Prompt:** 
```
What were the top 3 fraud reasons last week?
```

**Response:** 
```
Reviewing your recent analyses... I found a cluster of issues in 'Shipping Address Mismatch' and 'High-Value Repeat Orders.'

**Top Fraud Reasons (Last 7 Days):**
1.  Address mismatch: 28% of flagged orders.
2.  Velocity scoring: 20% of flagged orders.
3.  Payment method history: 15% of flagged orders.

Would you like me to list the specific IDs related to address mismatches?
```

**Prompt:** 
```
Mark order #ped_98765 as 'Cancelled' and tell me why.
```

**Response:** 
```
**Status Update Confirmation**
The status for ped_98765 has been successfully changed to **Cancelled (CAN)** in the ClearSale system. This update ensures that downstream processes recognize this order is invalid, preventing fulfillment errors.
```

## Capabilities

### Submit orders for fraud scoring
Send detailed order information to get immediate, real-time fraud analysis and scoring.

### Check live fraud status
Get the current status of any specific order ID through ClearSale's ongoing fraud analysis process.

### Update order statuses
Change an order’s official status within ClearSale, such as marking it as Approved or Cancelled.

### Review recent transaction history
List and examine a summary of orders that have been analyzed for fraud risk recently.

### Retrieve core account data
Pull necessary metadata about the ClearSale account itself, ensuring proper connectivity setup.

## Use Cases

### A suspicious order needs immediate vetting
An e-commerce manager receives a new order and asks their agent, 'What's the risk on this?' The agent uses submit_order_fraud_analysis to run a live score and tells them if it's safe or requires manual review.

### Closing out a bulk shipment of orders
A finance team member needs to confirm the status of 20 pending orders. They ask their agent to check all statuses, using get_order_fraud_status repeatedly until they have an approved list for fulfillment.

### Cleaning up canceled transactions
An operations team member finds a mistake and needs to mark multiple orders as cancelled. They use update_clearsale_order_status, setting the correct status across the board instantly.

### Understanding seasonal fraud spikes
A fraud analyst wants to review last quarter's activity. The agent calls list_recent_fraud_analyses and gives a summary report on the types of orders that failed scoring most often.

## Benefits

- Review recent analysis history using list_recent_fraud_analyses to spot fraud trends immediately, without manually navigating through order logs.
- Get instant status checks on any transaction with get_order_fraud_status; you don't have to wait for a manual dashboard refresh just to know if it passed scoring.
- Take decisive action by calling update_clearsale_order_status. You can change the official order status (Approved, Cancelled) right from your conversation.
- Initiate fraud reviews on demand using submit_order_fraud_analysis. Send orders for immediate, real-time risk scoring when they come in.
- Stay connected by calling get_clearsale_account_info to verify that the MCP connection is working correctly before running critical reports.

## How It Works

The bottom line is you manage complex e-commerce risk decisions entirely through chat, without having to log into the dedicated fraud dashboard.

1. Subscribe to this MCP and provide your required ClearSale API Username and Password.
2. Your agent authenticates with your credentials, establishing a direct connection to the fraud analysis system.
3. You initiate tasks using natural language—for example, asking to check an order's status or submitting a batch of orders for scoring.

## Frequently Asked Questions

**How does ClearSale MCP help me with daily fraud review?**
It lets you check transaction status and risk scores in natural language. Instead of opening multiple tabs on the ClearSale site, your agent gives you a summarized report right where you're working.

**I need to update order statuses, can ClearSale MCP do that?**
Yes, absolutely. You use the MCP to directly update an order’s status—like marking it Approved or Cancelled—within the ClearSale system using a simple chat command.

**Is this good for tracking historical fraud activity with ClearSale?**
It is. You can list and review recently analyzed orders to understand patterns, which helps your team spot trends before they become major issues.

**Can I use ClearSale MCP if my client doesn't have an order ID ready?**
You don't need the specific ID immediately. You can submit a batch of orders for analysis first, and then retrieve their status later when you need it.

**Does ClearSale MCP work with other AI clients besides Claude or Cursor?**
The MCP standard lets your agent connect from any compatible client. You just use the Vinkius catalog to link your account once, and it works everywhere.