• VALID
  • INVALID
  • INFO
  • MANUAL

How to validate card accounts with your AI

Connect Mastercard once. After that, your agent handles the heavy lifting of checking card status and issuer details during your payment workflows.

Ask AI about this page

Short answer

Can my AI check if a card is active and find its issuer?

Yes. Your agent uses the Mastercard MCP to run account validations and look up BIN data. This ensures you identify the correct issuer and card status before any transaction occurs.

Where every outcome lands.

The results of your validation

The AI sorts its findings into these specific categories based on the card data it pulls.

VALID

Active accounts

The agent confirms the card is active and ready for use. You get a clear signal to proceed with the payment.

INVALID

Declined or dead cards

The agent identifies accounts that are inactive or invalid. This prevents failed transactions later in your process.

INFO

Issuer identification

The agent pulls the specific bank or institution tied to the card. You'll know exactly which issuer is behind the account.

MANUAL

Human review needed

If the data is ambiguous or the account status is unclear, the agent flags it for you. You decide how to handle these edge cases.

The workflow

What your AI does when a card number is provided.

Your agent follows a specific sequence to turn a raw card number into actionable payment data.

  1. Check account status

    The agent first checks if the account is currently active and valid for transactions.

    validate_account

  2. Identify the issuer

    The agent looks up the Bank Identification Number to find out which institution issued the card.

    bin_lookup

  3. Verify card details

    The agent cross-references the account status with the issuer information to ensure consistency.

    validate_accountbin_lookup

  4. Flag for review

    If the validation fails or the issuer is unknown, the agent stops and alerts you.

    validate_account

Try it

Copy these to start.

Use these prompts to trigger the Mastercard MCP in your chat.

Starting points

These are basic starting lines. Replace the bracketed text with your actual card numbers or data sources.

Mastercard Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_NVEdiwOFK39oo4SxhoHISBVJABh2JC4PqWkfuar2/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Mastercard capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "mastercard-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_NVEdiwOFK39oo4SxhoHISBVJABh2JC4PqWkfuar2/mcp"
    }
  }
}
Copy into chat04

  • Validate this card account: [card number]

  • Use the Mastercard tools to find the issuer for this BIN: [bin number]

  • Check if the card in my Google Sheet [link] is active and identify its issuer.

  • Run a validation on this list of card numbers from my CSV: [file path]

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Mastercard once, then ask.

You only need to link your account once. Your credentials stay encrypted, and you can immediately start asking your agent to validate cards.

Connect Mastercard to your AI

FAQ

How this task behaves

  • 01

    Can the AI process the actual payment?

    No. The AI only validates the account and identifies the issuer. You must use your own payment gateway to actually move money.

  • 02

    Does the AI store my card numbers?

    No. The AI uses the tools to check the data, but it does not save or store sensitive card details in its memory.

  • 03

    Can the AI change the status of a card?

    No. The tools are read-only for validation and lookup. The AI cannot activate or deactivate any accounts.

  • 04

    What happens if the BIN lookup fails?

    If the agent cannot find the issuer, it will tell you the lookup failed and leave the decision to you.

  • 05

    Can I use this with any AI client?

    Yes, as long as you are using an MCP-compatible client like Claude, Cursor, or Windsurf.

  • More questions about Mastercard? The Connector page answers them. See everything the Mastercard Connector can do

Connect Mastercard to Claude, Cursor, ChatGPT & more