# ClearSale MCP for AI Agents AI Agent Connect

> ClearSale MCP lets you manage e-commerce fraud prevention directly through your AI agent. Submit orders for scoring, monitor fraud statuses, and update transaction results in real-time without switching tabs.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_fApiUyRYXoQSu1hbn5fIfLPu4mot4wOJPGfbqjHb/ai-agent-connect
- **Tags:** fraud-prevention, transaction-analysis, order-scoring, risk-management, chargeback-protection

## Description

This Connector connects your ClearSale account to your AI agent so you can handle fraud prevention tasks using natural language. Instead of jumping between different tabs to check if a transaction is risky, you can just ask your agent for the status of a specific order. It handles the heavy lifting of pulling fraud scores and analysis reasons, giving you a clear picture of your risk profile in a single chat window. You can also push updates back to the system, like marking an order as approved or cancelled, which keeps your records accurate. Having this in your Vinkius catalog means you can keep your risk management workflow contained in one place. It turns a manual process of hunting for data into a simple conversation where you just tell the agent what to check or update.

## Tools

### get_clearsale_account_info
Get your core account and connectivity metadata. This helps you confirm your API is linked correctly.

### submit_order_fraud_analysis
Submit detailed order data for real-time fraud scoring and manual analysis. This gets you the risk data you need immediately.

### update_clearsale_order_status
Update order statuses like Approved or Cancelled in the ClearSale system. This keeps your records synced with your decisions.

### get_order_fraud_status
See the current fraud analysis status for any specific order ID. Use this to check if a transaction is ready for a decision.

### list_recent_fraud_analyses
Review a list of recently analyzed orders to spot fraud trends. It helps you see what's happening across your store.

## Prompt Examples

**Prompt:** 
```
Check the fraud status for order #ped_12345.
```

**Response:** 
```
Retrieving status for order ped_12345... ClearSale has **Approved** this order with a fraud score of 15. No further manual analysis is required.
```

**Prompt:** 
```
List my last 5 fraud analyses.
```

**Response:** 
```
Checking recent analyses... I found 5 orders:

* 3 Approved
* 1 Denied (Score: 95)
* 1 in Manual Analysis

Would you like to see the reasons for the denied order?
```

**Prompt:** 
```
Mark order #ped_98765 as 'Cancelled' in ClearSale.
```

**Response:** 
```
Updating order ped_98765... The status has been successfully set to **Cancelled (CAN)** in the ClearSale system.
```

## Capabilities

### Submit orders for fraud scoring
Send order data to ClearSale to get a real-time fraud score and analysis.

### Check current analysis status
Find out the current fraud status for any specific order ID instantly.

### Update order statuses
Change an order to Approved or Cancelled directly through your chat interface.

### List recent fraud analyses
View a list of the most recent orders that were analyzed for risk.

### Retrieve account connectivity
Get your core account and connectivity metadata to ensure your setup is live.

### Get detailed fraud scores
Pull the specific fraud scores and the reasons provided by ClearSale for an order.

## Use Cases

### Checking a flagged order
A manager sees a high-risk alert and asks the agent to check the fraud status for order #123 using get_order_fraud_status.

### Batch updates
An analyst finishes a manual review and tells the agent to mark five orders as Approved using update_clearsale_order_status.

### Trend spotting
An ops lead asks for a list of recent analyses to see if a specific fraud type is spiking using list_recent_fraud_analyses.

### Connectivity check
An engineer wants to make sure the ClearSale API is still active and pulling data correctly using get_clearsale_account_info.

## Benefits

- Stop switching tabs by using submit_order_fraud_analysis to get scores instantly in your chat.
- Speed up manual reviews by using get_order_fraud_status to see if a transaction is ready for a decision.
- Keep your records clean by using update_clearsale_order_status to sync your final decisions back to the source.
- Spot patterns faster by using list_recent_fraud_analyses to see what's been happening lately.
- Confirm your setup is live by using get_clearsale_account_info to check connectivity metadata.
- Understand the why behind a flag by getting detailed analysis reasons directly in your conversation.

## How It Works

The bottom line is you get a direct line to your fraud prevention data without leaving your chat app.

1. Subscribe to the ClearSale MCP on Vinkius.
2. Enter your ClearSale API Username and Password in your AI client.
3. Ask your agent to check scores, list recent analyses, or update order statuses.

## Frequently Asked Questions

**What can I do with the ClearSale MCP?**
You can manage your e-commerce fraud prevention directly through your AI agent. This includes submitting orders for analysis, checking fraud scores, and updating order statuses.

**Can I check fraud scores for specific orders?**
Yes. You can ask your agent to pull the current fraud status and score for any specific order ID to see if it needs manual review.

**How do I update an order status using ClearSale?**
You can tell your agent to update the status of an order to Approved or Cancelled. The Connector will sync that change directly with the ClearSale system.

**Can I see a history of recent fraud checks?**
Yes, you can ask your agent to list recently analyzed orders. This helps you see recent fraud trends and analysis results in one list.

**How does ClearSale help with e-commerce security?**
It provides real-time fraud scoring and transaction analysis. By connecting it to your AI agent, you can make faster, more accurate security decisions.

**Can I check if my ClearSale account is connected correctly?**
Yes. You can ask your agent to retrieve your account connectivity metadata to ensure your API is properly linked and ready to use.

**Can I see the fraud score for a specific order?**
Yes! Use the `get_order_fraud_status` tool with the unique order ID. The agent will return the current status and the fraud score assigned by ClearSale's engine.

**How do I update an order to 'Approved' in ClearSale through the agent?**
Use the `update_clearsale_order_status` tool. Provide the order ID and the new status code (e.g., 'APR' for Approved). Your agent will instruct ClearSale to update the record accordingly.

**Where do I find my ClearSale API credentials?**
These credentials (Username and Password) are provided when you set up your account with ClearSale. You can typically find them or manage them within your ClearSale Merchant Dashboard.