Vinkius

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.

Mastercard MCP is compatible with Claude Claude
Mastercard MCP is compatible with ChatGPT ChatGPT
Mastercard MCP is compatible with Cursor Cursor
Mastercard MCP is compatible with Gemini Gemini
Mastercard MCP is compatible with Windsurf Windsurf
Mastercard MCP is compatible with VS Code VS Code
Mastercard MCP is compatible with JetBrains JetBrains
Mastercard MCP is compatible with Vercel Vercel
See Vinkius in Action

Give Claude and any AI agent real-world access

Determine card issuer and type

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.

Validate account status

Check if a full payment card number is currently active and valid before initiating any transaction, preventing costly declines.

Find merchants by location or address

Search for Mastercard-accepting businesses near specific GPS coordinates or using a user-friendly street address input.

Identify local payment capabilities

Discover nearby locations and pinpoint if they accept digital wallets like Apple Pay, Google Pay, or contactless methods.

Report confirmed fraud cases

Submit details of a fraudulent transaction to Mastercard's database for network protection and analysis.

Waiting for input…

AI Agent
Mastercard

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 MCP

Bin 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.

Mastercard MCP is compatible with Claude

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Mastercard integration is available immediately — no restart needed.

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
Start building

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
Mastercard MCP server cover

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

Your data is protected. See how we built it.

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.

Built · Hosted · Managed by Vinkius Mastercard - Find Merchants & Validate Cards MCP
Server ID 019d75d0-036e-71cd-91de-74e97c087863
Vinkius Inspector
Compliance Grade A+
Score 98.33/100
Vinkius Inspector Badge — Score 98.33/100

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.