FraudLabs Pro MCP Server

The Model Context Protocol (MCP) server is a lightweight communication layer built to manage and coordinate AI model operations within a structured runtime environment. It enhances model efficiency and performance when handling complex or multi-step workflows. FraudLabs Pro MCP Server helps merchants to screen any order transactions and user-related events like logins or registrations to identify and prevent fraudulent activities.

Available on: glama.ai GitHub

Getting Started

Requirements

Before using the FraudLabs Pro MCP Server, make sure Python is installed and you have a FraudLabs Pro API key.

1. Install Python and dependencies

Python 3.10 or above is required to run the MCP server. Some dependencies are also required to install beforehand, you can install it with this command: 

pip install mcp httpx uv

2. Get a FraudLabs Pro API key

The FraudLabs Pro API key allows the MCP server to connect with FraudLabs Pro and perform fraud screening requests.

SIGN UP FOR A FREE API KEY

Installation

  1. Download the latest release of the MCP server from the GitHub repository.
  2. To use this MCP server in Claude Desktop, you will need to modify the Claude Desktop configuration file called claude_desktop_config.json. 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": "uv",
      "args": [
        "--directory",
        "C:\\OoiKaiWen\\work\\code\\MCP\\fraudlabspro\\src",
        "run",
        "server.py"
      ],
      "env": {
        "FRAUDLABSPRO_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

How do I use the FraudLabs Pro MCP Server?

Order Transaction

This MCP Server supports screen an order by the order details, retrieve the screening result of an order, and update the status for an order from pending-manual-review to APPROVE, REJECT or REJECT_BLACKLIST.

Screen an Order

To screen an order, you can try the example prompts below:

  • Help me to validate this: [order_details]
  • Help me to validate the following: [order_details]
  • Help me to validate an order with the details at below: [order_details]

You can pass your order details as a JSON object, for example:


	"ip": "IP_Address",
	"last_name": "Henderson",
	"first_name": "Hector",
	"bill_addr": "1766 PowderHouse Road",
	"bill_city": "Cleveland",
	"bill_state": "OH",
	"bill_zip_code": "44115",
	"bill_country": "US",
	"ship_last_name": "Henderson",
	"ship_first_name": "Hector",
	"ship_addr": "4987 Bingamon Road",
	"ship_city": "Cleveland",
	"ship_state": "OH",
	"ship_zip_code": "44115",
	"ship_country": "US",
	"email_domain": "gmail.com",
	"user_phone": "440-5551961",
	"email_hash": "Email_Hash",
	"bin_no": "558265",
	"bank_name": "Bank of Ocean View",
	"bank_phone": "212-500-2489",
	"card_hash": "Card_Hash",
	"avs_result": "Y",
	"cvv_result": "M",
	"user_order_id": "7893",
	"amount": "99.95",
	"quantity": "1",
	"department": "Online Store",
	"payment_gateway": "stripe"
	"payment_mode": "creditcard"
}

Retrieve an Order Result

To retrieve the screening result for an order, you can try the example prompts below:

  • Help me retrieve the detail for the transaction [transaction ID]
  • I want to check the order transaction [transaction ID]
  • Get the screening result for [transaction ID]

Update an Order Status

To update the status of an order, just use this prompt:

  • I want to {APPROVE/REJECT/REJECT_BLACKLIST} the transaction [transaction ID].

User Transaction

This MCP Server supports screen a user transaction with the supplied details, retrieve the screening result of a user transaction, and update the status for a user transaction from pending-manual-review to APPROVE, REJECT or REJECT_BLACKLIST.

Screen a User Transaction

To screen a user transaction, you can try the example prompts below:

  • Help me to validate this: [user_details]
  • Help me to validate the following: [user_details]
  • Help me to validate an order with the details at below: [user_details]

You can pass your user details as a JSON object, for example:

{
	"email": "hh5566@gmail.com",
	"ip": "IP_Address",
	"last_name": "Henderson",
	"first_name": "Hector",
	"phone": "561-628-8674"
}

Retrieve a User Transaction Result

To retrieve the screening result for a user transaction, you can try the example prompts below:

  • Help me retrieve the detail for the user transaction [transaction ID]
  • I want to check the user transaction [transaction ID]
  • Get the screening result for the user transaction [transaction ID]

Update a User Transaction Status

To update the status of a user transaction, just use this prompt:

  • I want to {APPROVE/REJECT/REJECT_BLACKLIST} the transaction [transaction ID].

Ready to Use FraudLabs Pro MCP Server?

Enable fraud screening in your MCP-compatible AI assistant with a free FraudLabs Pro API key.

GET A FREE API KEY