English Français العربية

io.github.fraudlabspro/mcp-fraudlabspro

السجل الرسمي الأمن

Fraud Prevention MCP server using FraudLabs Pro API.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package mcp-fraudlabspro
Claude Code 
claude mcp add mcp-fraudlabspro -e 'FRAUDLABSPRO_API_KEY=<your fraudlabspro_api_key>' -- uvx mcp-fraudlabspro==1.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-fraudlabspro": {
            "command": "uvx",
            "args": [
                "mcp-fraudlabspro==1.1.1"
            ],
            "env": {
                "FRAUDLABSPRO_API_KEY": "<your fraudlabspro_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • FRAUDLABSPRO_API_KEY إلزامي سري Your FraudLabs Pro API key.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. FraudLabs Pro MCP Server
  2. Features
  3. Prerequisites
  4. Installation
  5. Available Tools
  6. Development & Logging
  7. License

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

  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: ~/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

ToolDescriptionKey Arguments
screen_orderScreen an order for fraud.ip, email, amount, bin_no, bill_country, ship_country
get_order_resultRetrieve the validation result for a previous order.transaction_id
feedback_orderUpdate order status (APPROVE, REJECT, BLACKLIST).transaction_id, action, note

👤 User Management

ToolDescriptionKey Arguments
screen_userScreen user events like logins or signups.email, ip, phone, first_name, last_name
get_user_resultRetrieve results for a previous user screening.user_transaction_id
feedback_userUpdate 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.

الأسئلة الشائعة

ما هو io.github.fraudlabspro/mcp-fraudlabspro؟

Fraud Prevention MCP server using FraudLabs Pro API.

كيف أثبّت io.github.fraudlabspro/mcp-fraudlabspro؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-fraudlabspro -e 'FRAUDLABSPRO_API_KEY=<your fraudlabspro_api_key>' -- uvx mcp-fraudlabspro==1.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.fraudlabspro/mcp-fraudlabspro إلى مفتاح API؟

نعم. يتطلب FRAUDLABSPRO_API_KEY، وتضبطها في إعداداته.

هل io.github.fraudlabspro/mcp-fraudlabspro مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.fraudlabspro/mcp-fraudlabspro؟

ينشره fraudlabspro. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.