How to Use the Mastercard MCP in Claude

Q: Can Claude Desktop use Mastercard to find places that accept Apple Pay?

Yes. The searchplaces tool accepts a boolean filter for digital wallets. Claude will return a list of merchants within your specified radius that explicitly support Apple Pay or Google Pay.

Q: Does the integration support batch BIN lookups?

No. You run binlookup one prefix at a time. If you need to analyze a spreadsheet of BINs, you can ask Claude to loop through the rows and call the tool for each entry.

Connect Claude Desktop to the Mastercard MCP Server to validate accounts, pull merchant data, and file fraud reports from your chat window.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mastercard MCP to Claude Desktop

Create your Vinkius account to connect Mastercard to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mastercard with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query BIN data and validate accounts in Claude

The `validate_account` tool checks if a payment card is active and valid before you process a transaction. You hand Claude the full account number, and it returns the validation status, account type, and issuer data. This cuts down on declined transactions during onboarding. If you just need the issuer details without hitting the validation endpoint, the `bin_lookup` tool pulls the bank name, card type, and issuing country from the first six to eight digits. You can run these checks directly in Claude Desktop while reviewing customer support tickets or analyzing payment logs. For compliance-heavy environments, `bin_lookup_post` shifts the payload to a POST request to keep sensitive card fragments out of your URL parameters.

Map merchant locations and category codes

The `search_merchants` tool finds Mastercard-accepting businesses near specific GPS coordinates. You feed it a latitude, longitude, and a search radius in meters. Claude returns exact coordinates and the 4-digit classification for each business. If you need to know what those four digits mean, `merchant_category_codes` decodes them into plain English, like 5411 for grocery stores. When you need the full profile of a specific shop, `get_merchant` pulls the operating hours, contact info, and accepted payment methods using the merchant ID. You can also use `search_places_by_address` if you only have a street address and need Claude to handle the geocoding internally before returning the nearby payment infrastructure.

File confirmed fraud reports via this MCP Server

The `submit_fraud_report` tool pushes confirmed fraudulent transaction data straight to the Mastercard Fraud and Loss Database. You provide the account number, transaction amount, currency, and a specific fraud type code like "01" for stolen cards. This is a write operation. It requires authorized access and only accepts confirmed cases, never suspected disputes. Filing these reports trains the network to reduce false positives for future transactions. Claude structures the payload and handles the API request, meaning your fraud management team can report bad actors without leaving their chat interface or writing custom integration scripts.

Setup guide

Set up Mastercard MCP in Claude Web or Desktop

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 MCP tools are available immediately — no restart needed.

Endpoint URL

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

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Mastercard MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under mastercard-mcp.

json

{
  "mcpServers": {
    "mastercard-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mastercard now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mastercard MCP in Claude Desktop

Open your Claude Desktop settings and click on Developer to edit the configuration file. Add the Vinkius endpoint URL under the mcpServers key. Restart the application to see the tools appear in your chat interface.

Yes. The `search_places` tool accepts a boolean filter for digital wallets. Claude will return a list of merchants within your specified radius that explicitly support Apple Pay or Google Pay.

The API will reject the request. You must use exact string codes like "02" for cards never received or "04" for counterfeit fraud.

No. You run `bin_lookup` one prefix at a time. If you need to analyze a spreadsheet of BINs, you can ask Claude to loop through the rows and call the tool for each entry.

This MCP integration processes full Primary Account Numbers (PANs) when using the validation endpoints. Vinkius isolates the execution in an ephemeral V8 sandbox that destroys itself after the request finishes. Zero data touches disk, and the connection requires a single endpoint token rather than exposing your raw API credentials to the local machine.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript