Mastercard MCP. Get instant payment intelligence from any location.
Mastercard MCP gives your AI client instant access to global payment intelligence. Identify card issuer details from the first few digits (BIN lookup), validate account status before transactions, locate specific merchants using GPS coordinates or street addresses, and report confirmed fraud cases directly. It's a single connection point for everything related to modern commerce payments.
Give Claude and any AI agent real-world access
Read the first 6-8 digits of any card number to instantly identify the bank that issued it, whether it's credit or debit, and its specific premium category.
Check if a full payment card number is currently active and valid before initiating any transaction, preventing costly declines.
Search for Mastercard-accepting businesses near specific GPS coordinates or using a user-friendly street address input.
Discover nearby locations and pinpoint if they accept digital wallets like Apple Pay, Google Pay, or contactless methods.
Submit details of a fraudulent transaction to Mastercard's database for network protection and analysis.
Ask an AI about this
Waiting for input…
What AI agents can do with Mastercard MCP: 12 Tools for Payments
These twelve tools give your AI agent the ability to perform complex tasks like card validation, merchant discovery, and fraud reporting through simple conversation.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Mastercard MCPBin Lookup
Identifies a card's issuer bank, type (credit/debit), and category using only the first 6 to 8 digits of the card number.
Bin Lookup Post
Performs the same card identification lookup as bin_lookup but uses a POST method...
Get Merchant
Retrieves detailed information, including hours and accepted methods, for a specific...
Get Place Details
Gets complete details, like coordinates and payment types, for any location found...
Merchant Category Codes
Provides a comprehensive list of all four-digit Merchant Category Codes used to...
Merchant Industry Codes
Lists higher-level industry codes, grouping related MCCs for broader market analysis and business classification.
Nearby Locations
Discovers general points of interest, including ATMs or merchants, within a given radius from specific GPS coordinates.
Search Merchants
Finds Mastercard-accepting businesses near GPS coordinates and allows filtering by...
Search Places
Searches for nearby locations using GPS, specifically filtering results to show...
Search Places By Address
Finds specific merchant places by providing a street address instead of raw...
Submit Fraud Report
Allows authorized users to submit confirmed fraudulent transaction details directly...
Validate Account
Checks a full card number against the network to confirm if it is currently active and valid for immediate transactions.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Mastercard, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mastercard. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The pain of fragmented payment data
Today, if you need to know what kind of card a customer has or where they can spend it, you hit multiple roadblocks. You might check one API for BIN lookup, then switch to a separate map service to find the physical store, and finally use a third portal just to see if that location accepts Apple Pay. It’s copy-pasting coordinates into five different tabs until your agent throws an error.
With this MCP, all of that complexity disappears. You tell your AI client the goal—for instance, 'Find me a merchant near downtown that takes digital wallets.' Your agent runs through the necessary checks using `search_places`, confirms payment methods, and gives you one clean answer. It just works.
Mastercard MCP: Location Search and Validation
Before this MCP, finding a business meant guessing its location type or relying on manual cross-referencing of MCC codes against local directories. You couldn't easily tell if a merchant accepting credit cards was also set up to handle Apple Pay.
Now, your agent handles the entire query sequence automatically. It combines geographic searching with payment capability checks in one conversational step. The intelligence is immediate and actionable.
What Mastercard MCP does for your AI
Mastercard connects deep payment infrastructure capabilities directly to your agent through this MCP. You get instant intelligence on cards, merchants, and transactions without having to jump between complex developer portals or write boilerplate API code. Need to know if a card is active before processing a charge? Ask the AI.
Trying to find a restaurant that takes contactless payments nearby? The MCP handles the geospatial search and payment capability filtering automatically.
This isn't just another data dump; it’s a conversational layer over global financial rules. You can determine everything from business classification using MCC codes to finding detailed merchant information, all through simple conversation with your AI client. Connecting this via Vinkius means you get immediate access to the full suite of payment tools, letting your agent act like an expert payments analyst on demand.
019d75d0-036e-71cd-91de-74e97c087863 How to set up Mastercard MCP
The bottom line is you never have to write a single API call yourself; you just ask your AI client what payment intelligence you need.
Subscribe to the MCP and provide your Mastercard Developer Client ID and Client Secret.
Your AI client uses natural language to formulate a request, specifying what it needs—for example, 'Find restaurants near 34th Street that accept digital wallets.'
The MCP executes the necessary background calls, gathers data on merchants or card details, and presents the final answer directly back through your agent.
Who uses Mastercard MCP
This MCP is critical for anyone whose daily job involves verifying financial data or locating physical points of sale. It’s built for fraud analysts who need to investigate suspicious activity fast, and e-commerce operators struggling with high payment decline rates.
Building checkout flows that must validate card numbers or determine optimal payment routing before processing a charge.
Investigating flagged transactions by running BIN lookups to check issuer details and submitting fraud reports for suspicious activity.
Helping clients find specific types of local businesses, ensuring those merchants accept modern payment methods like digital wallets or contactless pay.
Benefits of connecting Mastercard MCP
Reduces transaction decline rates by running accounts through the validate_account tool, ensuring you only process payments on active cards. This saves time and money immediately.
Finds merchants using either coordinates (search_merchants) or a simple street address (search_places_by_address), making location queries much more user-friendly for any client.
Quickly identifies card details using bin_lookup, letting your agent tell you the issuer bank, card tier (Gold/Platinum), and country from just the first few digits of a number.
Enhances customer service by searching for locations that accept specific digital wallets. Use search_places to filter results specifically for Apple Pay or Google Pay support.
Improves compliance workflows by allowing authorized personnel to use submit_fraud_report, feeding confirmed fraud data back into the network immediately.
Mastercard MCP use cases
A traveler needs a local store that accepts digital payments.
The user asks: 'Where's a coffee shop near me that takes Apple Pay?' The agent uses search_places with the current GPS coordinates and filters for Apple Pay acceptance, returning precise results.
A fraud analyst needs to investigate suspicious transaction batch data.
The user asks: 'What is the issuer bank behind these card numbers?' The agent runs bin_lookup on the partial number, immediately telling the analyst if it's a corporate or prepaid account.
An e-commerce developer needs to validate customer inputs before checkout.
The user asks: 'Is this card number active?' The agent executes validate_account with the full PAN, giving a definitive VALID/INVALID status so the payment gateway doesn't waste time.
A sales team needs to find potential retail partners in a new district.
The user asks: 'Show me all local restaurants near 123 Main St.' The agent uses search_places_by_address and then uses the resulting IDs with get_place_details to pull complete contact info.
Mastercard MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Searching for merchants without a location.
Asking, 'Where can I find a gas station?' The system cannot answer because the tool requires coordinates or an address to define the search area.
Always provide context. Instead of asking generally, ask: 'Find gas stations near 34th Street.' Use nearby_locations or search_merchants with specific GPS data.
Assuming card type from the number.
Looking at a partial number and guessing if it's debit, credit, or prepaid. This is unreliable and risks transaction failure.
Use bin_lookup to get a definitive breakdown. It tells you the exact card category (Standard/Gold) and whether it’s commercial or consumer.
Trying to analyze raw MCC codes manually.
Getting a list of 4-digit MCC codes and trying to figure out what they mean. The codebook is massive and hard to read.
First, use merchant_category_codes or merchant_industry_codes to understand the classification hierarchy before filtering your searches.
When to use Mastercard MCP
Use this MCP if your primary need is intelligence about transactions, locations, or businesses. If you are validating a card number, you must use validate_account. If you are finding physical places, always start with location-based tools like search_merchants or search_places_by_address, as these provide the necessary coordinates to make sense of the data. Don't use this if your goal is simply retrieving a static list of all global MCC codes; for that, just call merchant_category_codes. You shouldn't rely on this MCP if you only need basic contact information without payment acceptance details—you might be better off using a simple directory API instead. This tool is specialized for the complex intersection of commerce and finance.
Frequently asked questions about Mastercard MCP
Can I identify what bank issued a card just from the first few digits? +
Yes! Use the bin_lookup tool 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.
How can I find merchants that accept Mastercard near a specific location? +
Use the search_merchants tool 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.
Can I verify if a payment card is valid before processing a transaction? +
Yes! Use the validate_account tool 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.
How do I report a confirmed fraudulent transaction to Mastercard? +
Use the submit_fraud_report tool 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 tool for confirmed cases.
Can I find merchants that accept Apple Pay or Google Pay near me? +
Yes! Use the search_places tool 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.