Mastercard Connector for AI agents.

Yes, it can find merchants near your current GPS coordinates or a specific street address. You can even filter the results to find places that accept specific payment methods.

You can use the Connector to report confirmed fraudulent transactions to the official database. This helps the network identify stolen cards and reduce future fraud.

Yes, it uses BIN lookup to identify if a card is a commercial, prepaid, or personal card. This helps you understand the cardholder's profile before processing a payment.

Yes, the Connector can search for merchant locations that specifically support Apple Pay or Google Pay, making it useful for travel and concierge apps.

Yes, you can use it to verify if a payment card is active and valid before you attempt to process a transaction. This is a great way to reduce declined payments.

MCC codes are 4-digit numbers used to classify different types of businesses, like grocery stores or restaurants. The Connector gives you access to the full database of these codes.

Yes! Use the bin_lookup capability with the first 6-8 digits of the card number (the BIN). Mastercard will return the issuer bank name, card type (credit/debit/prepaid), card category (Gold/Platinum/World), issuing country, and flags like whether it's a commercial or healthcare card. For example, BIN 542418 reveals the exact issuing bank and card tier.

Use the search_merchants capability with latitude, longitude, and a search radius in meters. You can optionally filter by MCC code (e.g., "5812" for restaurants, "5411" for grocery stores). For example, searching with coordinates -23.5505, -46.6333 (São Paulo) and radius 5000 will return all Mastercard-accepting merchants within 5km. Results include merchant names, addresses, categories, and coordinates.

Yes! Use the validate_account capability with the full card number. It checks Mastercard records to determine if the card is active and valid, returning the validation status (VALID/INVALID), account type (credit/debit/prepaid), and issuer information. Optionally include expiry date (MMYY format) and cardholder name for enhanced validation. This helps reduce declined transactions and fraud risk. Never store full card numbers. handle them securely.

Use the submit_fraud_report capability with the card number, transaction amount, currency (ISO 4217), and fraud type code. Fraud types: "01" = Stolen Card, "02" = Never Received Card, "03" = Fraudulent Application, "04" = Counterfeit Card. Optionally include fraud amount and transaction date. This submits to Mastercard's Fraud and Loss Database (FLD) to help reduce false positives across the network. IMPORTANT: Only authorized fraud management personnel should use this capability for confirmed cases.

Yes! Use the search_places capability with GPS coordinates and set hasApplePay=true or hasGooglePay=true to filter for merchants with those payment capabilities. Returns detailed merchant information including names, addresses, MCC codes, and which digital wallets they accept. For example, searching near Times Square (40.7580, -73.9855) with hasApplePay=true will show all nearby Apple Pay-enabled merchants.