Fraudlabs Pro
About
FraudLabs Pro MCP server is a Model Context Protocol (MCP) server that provides order or user transaction validations using the FraudLabs Pro API. This server allows AI agents to validate an order or user transaction, get the validation result for an order or user transaction, an
Explore
- Order Screening: Validate e-commerce orders using IP addresses, billing/shipping details, and credit card information.
- User Screening: Analyze account-level events (registrations/logins) for suspicious patterns.
- Transaction Management: Retrieve historical results for orders or user screenings.
- Feedback Loop: Approve, Reject, or Blacklist transactions directly through the AI interface to improve the detection engine.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Fraudlabs ProCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Python 3.10+ installed.
- FraudLabs Pro API Key: You can obtain a free or paid API key at FraudLabs Pro.
screen_order
Screen an order for fraud.
get_order_result
Retrieve the validation result for a previous order.
feedback_order
Update order status (APPROVE, REJECT, BLACKLIST).
screen_user
Screen user events like logins or signups.
get_user_result
Retrieve results for a previous user screening.
feedback_user
Update user event status based on manual review.
📦 Order Management
| Tool | Description | Key Arguments |
|------|-------------|----------|
| screen_order | Screen an order for fraud. | ip, email, amount, bin_no, bill_country, ship_country |
| get_order_result | Retrieve the validation result for a previous order. | transaction_id |
| feedback_order | Update order status (APPROVE, REJECT, BLACKLIST). | transaction_id, action, note |
👤 User Management
| Tool | Description | Key Arguments |
|------|-------------|----------|
| screen_user | Screen user events like logins or signups. | email, ip, phone, first_name, last_name |
| get_user_result | Retrieve results for a previous user screening. | user_transaction_id |
| feedback_user | Update user event status based on manual review. | user_transaction_id, action, reason |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"fraudlabs pro": {
"fraudlabspro": {
"command": "uv",
"args": [
"--directory",
"/path/to/ip2locationio/src",
"run",
"server.py"
],
"env": {
"FRAUDLABSPRO_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
}McpServers
{
"fraudlabspro": {
"command": "uv",
"args": [
"--directory",
"/path/to/ip2locationio/src",
"run",
"server.py"
],
"env": {
"FRAUDLABSPRO_API_KEY": "YOUR_API_KEY_HERE"
}
}
}The FraudLabs Pro MCP Server is a powerful integration designed to bring high-performance fraud prevention intelligence directly into your LLM-driven workflows. By utilizing the Model Context Protocol (MCP), this server allows your AI agents to validate an order or user transaction, get the validation result for an order or user transaction, and update the status for an order or user transaction using a single natural language prompt.
Key Features
- Order Screening: Validate e-commerce orders using IP addresses, billing/shipping details, and credit card information.
- User Screening: Analyze account-level events (registrations/logins) for suspicious patterns.
- Transaction Management: Retrieve historical results for orders or user screenings.
- Feedback Loop: Approve, Reject, or Blacklist transactions directly through the AI interface to improve the detection engine.
Prerequisites
- Python 3.10+ installed.
- FraudLabs Pro API Key: You can obtain a free or paid API key at FraudLabs Pro.
Installation
1. Install Dependencies
Ensure you have the required libraries installed in your environment:
``
bash
pip install mcp httpx uv
`
2. Configuration
To use this server with an MCP client (such as Claude Desktop), add the following entry to your configuration file:
- macOS:
- Windows:
json
{
"mcpServers": {
"fraudlabspro": {
"command": "uv",
"args": [
"--directory",
"/path/to/ip2locationio/src",
"run",
"server.py"
],
"env": {
"FRAUDLABSPRO_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
`
Available Tools
📦 Order Management
| Tool | Description | Key Arguments |
|------|-------------|----------|
| screen_order | Screen an order for fraud. | ip, email, amount, bin_no, bill_country, ship_country |
| get_order_result | Retrieve the validation result for a previous order. | transaction_id |
| feedback_order | Update order status (APPROVE, REJECT, BLACKLIST). | transaction_id, action, note |
👤 User Management
| Tool | Description | Key Arguments |
|------|-------------|----------|
| screen_user | Screen user events like logins or signups. | email, ip, phone, first_name, last_name |
| get_user_result | Retrieve results for a previous user screening. | user_transaction_id |
| feedback_user | Update user event status based on manual review. | user_transaction_id, action, reason |
Development & Logging
The server uses FastMCP and sends logs through the MCP context. You can view logs in the Claude Desktop "Developer Console" to inspect outgoing payloads and API responses for debugging.
Common Error: If you receive "An API key is needed," ensure the License
See the LICENSE file.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
