io.github.fraudlabspro/mcp-fraudlabspro
Fraud Prevention MCP server using FraudLabs Pro API.
What can you do with io.github.fraudlabspro/mcp-fraudlabspro?
- 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.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
mcp-fraudlabsproclaude mcp add mcp-fraudlabspro -e 'FRAUDLABSPRO_API_KEY=<your fraudlabspro_api_key>' -- uvx mcp-fraudlabspro==1.1.1
{
"mcpServers": {
"mcp-fraudlabspro": {
"command": "uvx",
"args": [
"mcp-fraudlabspro==1.1.1"
],
"env": {
"FRAUDLABSPRO_API_KEY": "<your fraudlabspro_api_key>"
}
}
}
}
Environment variables
FRAUDLABSPRO_API_KEYrequired secret Your FraudLabs Pro API key.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
FraudLabs Pro MCP Server
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.
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: Sign up for a Free Micro Plan API Key at FraudLabs Pro.
Installation
- Install Dependencies Ensure you have the required libraries installed in your environment:
bash pip install mcp httpx uv - Configuration To use this server with an MCP client (such as Claude Desktop), add the following entry to your configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"fraudlabspro": {
"command": "uvx",
"args": [
"mcp-fraudlabspro"
],
"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 FRAUDLABSPRO_API_KEY environment variable is correctly set in your configuration file and that you have restarted the MCP client.
License
See the LICENSE file.
Frequently asked questions
What is io.github.fraudlabspro/mcp-fraudlabspro?
Fraud Prevention MCP server using FraudLabs Pro API.
How do I install io.github.fraudlabspro/mcp-fraudlabspro?
It runs on your machine. In Claude Code: claude mcp add mcp-fraudlabspro -e 'FRAUDLABSPRO_API_KEY=<your fraudlabspro_api_key>' -- uvx mcp-fraudlabspro==1.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.fraudlabspro/mcp-fraudlabspro need an API key?
Yes. It expects FRAUDLABSPRO_API_KEY, which you set in its configuration.
Is io.github.fraudlabspro/mcp-fraudlabspro open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.fraudlabspro/mcp-fraudlabspro?
It is published by fraudlabspro. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.