MCP 服务器

maxmind-minfraud

io.usefulapi/maxmind-minfraud
支付与金融科技 安全 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Scores payment transactions for fraud risk, returns detailed risk factors and attributes, and accepts transaction-outcome feedback for MaxMind minFraud.

minfraud_factors
minFraud Factors (risk reasons + subscores)
The most detailed assessment: everything in Insights PLUS risk_score_reasons and per-factor subscores explaining WHY the score is what it is. Same request body as minfraud_score. API: POST /minfraud/v2.0/factors.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'email': {'type': 'object', 'properties': {'domain': {'type': 'string'}, 'address': {'type': 'string', 'description': 'Plaintext email OR its MD5 hash.'}}}, 'event': {'type': 'object', 'properties': {'time': {'type': 'string', 'description': 'ISO 8601 timestamp of the event.'}, 'type': {'enum': ['account_creation', 'account_login', 'email_change', 'password_reset', 'payout_change', 'purchase', 'recurring_purchase', 'referral', 'survey'], 'type': 'string'}, 'shop_id': {'type': 'string'}, 'transaction_id': {'type': 'string'}}}, 'order': {'type': 'object', 'properties': {'amount': {'type': 'number'}, 'is_gift': {'type': 'boolean'}, 'currency': {'type': 'string', 'description': '3-letter ISO 4217 currency code.'}, 'affiliate_id': {'type': 'string'}, 'referrer_uri': {'type': 'string'}, 'discount_code': {'type': 'string'}, 'subaffiliate_id': {'type': 'string'}, 'has_gift_message': {'type': 'boolean'}}}, 'device': {'type': 'object', 'properties': {'ip_address': {'type': 'string', 'description': 'IPv4 or IPv6 address — the single most important field for scoring.'}, 'session_id': {'type': 'string'}, 'user_agent': {'type': 'string'}, 'session_age': {'type': 'number', 'description': "Seconds since the visitor's session started."}, 'accept_language': {'type': 'string'}}, 'description': 'Info about the device/connection. device.ip_address is the most important input.'}, 'account': {'type': 'object', 'properties': {'user_id': {'type': 'string'}, 'username_md5': {'type': 'string'}}}, 'billing': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'postal': {'type': 'string'}, 'region': {'type': 'string'}, 'address': {'type': 'string'}, 'company': {'type': 'string'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code.'}, 'address_2': {'type': 'string'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'phone_number': {'type': 'string'}, 'phone_country_code': {'type': 'string'}}}, 'payment': {'type': 'object', 'properties': {'processor': {'type': 'string'}, 'decline_code': {'type': 'string'}, 'was_authorized': {'type': 'boolean'}}}, 'shipping': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'postal': {'type': 'string'}, 'region': {'type': 'string'}, 'address': {'type': 'string'}, 'company': {'type': 'string'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code.'}, 'address_2': {'type': 'string'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'phone_number': {'type': 'string'}, 'delivery_speed': {'enum': ['same_day', 'overnight', 'expedited', 'standard'], 'type': 'string'}, 'phone_country_code': {'type': 'string'}}}, 'credit_card': {'type': 'object', 'properties': {'token': {'type': 'string'}, 'bank_name': {'type': 'string'}, 'last_digits': {'type': 'string', 'description': 'Last 2 or 4 digits.'}, 'issuer_id_number': {'type': 'string', 'description': '6- or 8-digit IIN.'}, 'bank_phone_number': {'type': 'string'}, 'bank_phone_country_code': {'type': 'string'}, 'was_3d_secure_successful': {'type': 'boolean'}}}, 'custom_inputs': {'type': 'object', 'description': 'Custom inputs configured in your minFraud account.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': ['string', 'number', 'boolean']}}, 'shopping_cart': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'item_id': {'type': 'string'}, 'category': {'type': 'string'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}}}}}
minfraud_insights
minFraud Insights (detailed risk)
Score a transaction AND get detailed risk insights: IP geolocation, email/address/device attributes, and per-component risk on top of the risk_score. Same request body as minfraud_score. API: POST /minfraud/v2.0/insights.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'email': {'type': 'object', 'properties': {'domain': {'type': 'string'}, 'address': {'type': 'string', 'description': 'Plaintext email OR its MD5 hash.'}}}, 'event': {'type': 'object', 'properties': {'time': {'type': 'string', 'description': 'ISO 8601 timestamp of the event.'}, 'type': {'enum': ['account_creation', 'account_login', 'email_change', 'password_reset', 'payout_change', 'purchase', 'recurring_purchase', 'referral', 'survey'], 'type': 'string'}, 'shop_id': {'type': 'string'}, 'transaction_id': {'type': 'string'}}}, 'order': {'type': 'object', 'properties': {'amount': {'type': 'number'}, 'is_gift': {'type': 'boolean'}, 'currency': {'type': 'string', 'description': '3-letter ISO 4217 currency code.'}, 'affiliate_id': {'type': 'string'}, 'referrer_uri': {'type': 'string'}, 'discount_code': {'type': 'string'}, 'subaffiliate_id': {'type': 'string'}, 'has_gift_message': {'type': 'boolean'}}}, 'device': {'type': 'object', 'properties': {'ip_address': {'type': 'string', 'description': 'IPv4 or IPv6 address — the single most important field for scoring.'}, 'session_id': {'type': 'string'}, 'user_agent': {'type': 'string'}, 'session_age': {'type': 'number', 'description': "Seconds since the visitor's session started."}, 'accept_language': {'type': 'string'}}, 'description': 'Info about the device/connection. device.ip_address is the most important input.'}, 'account': {'type': 'object', 'properties': {'user_id': {'type': 'string'}, 'username_md5': {'type': 'string'}}}, 'billing': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'postal': {'type': 'string'}, 'region': {'type': 'string'}, 'address': {'type': 'string'}, 'company': {'type': 'string'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code.'}, 'address_2': {'type': 'string'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'phone_number': {'type': 'string'}, 'phone_country_code': {'type': 'string'}}}, 'payment': {'type': 'object', 'properties': {'processor': {'type': 'string'}, 'decline_code': {'type': 'string'}, 'was_authorized': {'type': 'boolean'}}}, 'shipping': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'postal': {'type': 'string'}, 'region': {'type': 'string'}, 'address': {'type': 'string'}, 'company': {'type': 'string'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code.'}, 'address_2': {'type': 'string'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'phone_number': {'type': 'string'}, 'delivery_speed': {'enum': ['same_day', 'overnight', 'expedited', 'standard'], 'type': 'string'}, 'phone_country_code': {'type': 'string'}}}, 'credit_card': {'type': 'object', 'properties': {'token': {'type': 'string'}, 'bank_name': {'type': 'string'}, 'last_digits': {'type': 'string', 'description': 'Last 2 or 4 digits.'}, 'issuer_id_number': {'type': 'string', 'description': '6- or 8-digit IIN.'}, 'bank_phone_number': {'type': 'string'}, 'bank_phone_country_code': {'type': 'string'}, 'was_3d_secure_successful': {'type': 'boolean'}}}, 'custom_inputs': {'type': 'object', 'description': 'Custom inputs configured in your minFraud account.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': ['string', 'number', 'boolean']}}, 'shopping_cart': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'item_id': {'type': 'string'}, 'category': {'type': 'string'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}}}}}
minfraud_report_transaction
Report a transaction outcome
WRITE — submits fraud feedback to MaxMind. Report the real-world outcome of a transaction (e.g. it was a chargeback or confirmed fraud) so minFraud can improve future scoring. This mutates MaxMind's model of your traffic; it is not a read. Requires a `tag` and at least one identifier (ip_address, maxmind_id, minfraud_id, or transaction_id). API: POST /minfraud/v2.0/transactions/report (returns HTTP 204).
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['tag'], 'properties': {'tag': {'enum': ['not_fraud', 'suspected_fraud', 'spam_or_abuse', 'chargeback', 'clear'], 'type': 'string', 'description': 'REQUIRED. The outcome you are reporting for this transaction.'}, 'notes': {'type': 'string', 'description': 'Free-form notes about the transaction.'}, 'ip_address': {'type': 'string', 'description': 'Identifier: the IP address of the reported transaction.'}, 'maxmind_id': {'type': 'string', 'description': 'Identifier: the 8-character maxmind_id from a prior response.'}, 'minfraud_id': {'type': 'string', 'description': 'Identifier: the minfraud_id (UUID) from a prior response.'}, 'transaction_id': {'type': 'string', 'description': 'Identifier: your own transaction_id sent at scoring time.'}, 'chargeback_code': {'type': 'string', 'description': 'The chargeback reason code, if tag=chargeback.'}}}
minfraud_score
minFraud risk score
Score a transaction for fraud risk. Returns the overall risk_score (0.01–99), IP risk, disposition, and remaining query funds — the lightest, cheapest assessment. Send at least device.ip_address (plus email/billing/order for a better score). API: POST /minfraud/v2.0/score.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'email': {'type': 'object', 'properties': {'domain': {'type': 'string'}, 'address': {'type': 'string', 'description': 'Plaintext email OR its MD5 hash.'}}}, 'event': {'type': 'object', 'properties': {'time': {'type': 'string', 'description': 'ISO 8601 timestamp of the event.'}, 'type': {'enum': ['account_creation', 'account_login', 'email_change', 'password_reset', 'payout_change', 'purchase', 'recurring_purchase', 'referral', 'survey'], 'type': 'string'}, 'shop_id': {'type': 'string'}, 'transaction_id': {'type': 'string'}}}, 'order': {'type': 'object', 'properties': {'amount': {'type': 'number'}, 'is_gift': {'type': 'boolean'}, 'currency': {'type': 'string', 'description': '3-letter ISO 4217 currency code.'}, 'affiliate_id': {'type': 'string'}, 'referrer_uri': {'type': 'string'}, 'discount_code': {'type': 'string'}, 'subaffiliate_id': {'type': 'string'}, 'has_gift_message': {'type': 'boolean'}}}, 'device': {'type': 'object', 'properties': {'ip_address': {'type': 'string', 'description': 'IPv4 or IPv6 address — the single most important field for scoring.'}, 'session_id': {'type': 'string'}, 'user_agent': {'type': 'string'}, 'session_age': {'type': 'number', 'description': "Seconds since the visitor's session started."}, 'accept_language': {'type': 'string'}}, 'description': 'Info about the device/connection. device.ip_address is the most important input.'}, 'account': {'type': 'object', 'properties': {'user_id': {'type': 'string'}, 'username_md5': {'type': 'string'}}}, 'billing': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'postal': {'type': 'string'}, 'region': {'type': 'string'}, 'address': {'type': 'string'}, 'company': {'type': 'string'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code.'}, 'address_2': {'type': 'string'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'phone_number': {'type': 'string'}, 'phone_country_code': {'type': 'string'}}}, 'payment': {'type': 'object', 'properties': {'processor': {'type': 'string'}, 'decline_code': {'type': 'string'}, 'was_authorized': {'type': 'boolean'}}}, 'shipping': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'postal': {'type': 'string'}, 'region': {'type': 'string'}, 'address': {'type': 'string'}, 'company': {'type': 'string'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code.'}, 'address_2': {'type': 'string'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'phone_number': {'type': 'string'}, 'delivery_speed': {'enum': ['same_day', 'overnight', 'expedited', 'standard'], 'type': 'string'}, 'phone_country_code': {'type': 'string'}}}, 'credit_card': {'type': 'object', 'properties': {'token': {'type': 'string'}, 'bank_name': {'type': 'string'}, 'last_digits': {'type': 'string', 'description': 'Last 2 or 4 digits.'}, 'issuer_id_number': {'type': 'string', 'description': '6- or 8-digit IIN.'}, 'bank_phone_number': {'type': 'string'}, 'bank_phone_country_code': {'type': 'string'}, 'was_3d_secure_successful': {'type': 'boolean'}}}, 'custom_inputs': {'type': 'object', 'description': 'Custom inputs configured in your minFraud account.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': ['string', 'number', 'boolean']}}, 'shopping_cart': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'item_id': {'type': 'string'}, 'category': {'type': 'string'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}}}}}
已更改
minfraud_report_transaction
2026年10月1日 02:43
已更改
minfraud_factors
2026年10月1日 02:43
已更改
minfraud_insights
2026年10月1日 02:43
已更改
minfraud_score
2026年10月1日 02:43
已添加
minfraud_report_transaction
2026年9月21日 02:44
已添加
minfraud_factors
2026年9月21日 02:44
已添加
minfraud_insights
2026年9月21日 02:44
已添加
minfraud_score
2026年9月21日 02:44