This server wraps the FraudLabs Pro API to bring fraud detection directly into Claude. You get six tools split between order and user screening: validate e-commerce transactions with IP addresses and billing details, analyze registration and login events for suspicious patterns, pull historical results by transaction ID, and submit feedback (approve, reject, or blacklist) to train the detection engine. Built with FastMCP and uses stdio transport. You'll need a FraudLabs Pro API key and Python 3.10 or later. Useful if you're building commerce workflows or user onboarding processes and want real-time fraud checks without leaving your AI assistant.
An MCP-compliant server that integrates the FraudLabs Pro fraud detection system into AI assistants like Claude Desktop. This server enables real-time screening of order transactions and user-related events (like logins or registrations) to identify and prevent fraudulent activities.
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.
pip install mcp httpx uv
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"fraudlabspro": {
"command": "uvx",
"args": [
"mcp-fraudlabspro"
],
"env": {
"FRAUDLABSPRO_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
📦 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 |
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 FRAUDLABSPRO_API_KEY environment variable is correctly set in your configuration file and that you have restarted the MCP client.
See the LICENSE file.
FRAUDLABSPRO_API_KEY*secretYour FraudLabs Pro API key.