How to Use the Mastercard MCP in Windsurf
Give Windsurf direct access to Mastercard payment data and merchant locators to build fintech apps fast.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Mastercard MCP to Windsurf
Create your Vinkius account to connect Mastercard to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.
Validate cards with Windsurf
`validate_account` checks if a card number is active directly against the Mastercard network. Cascade runs this before you write your payment processing logic. You avoid testing against dead cards. You tell the agent to verify an account, and it hits the API, parses the response, and builds your error handling without asking for permission. `bin_lookup` pulls the issuing bank, card type, and country from the first six digits. Cascade chains these operations together. It checks the BIN, validates the account status, and stubs out your regional routing logic without you typing a single curl command. You get real data plugged straight into your IDE.
Automate fraud reporting pipelines
`submit_fraud_report` pushes confirmed fraud cases straight to the Mastercard network database. You give Cascade a test transaction payload. It maps the ISO 4217 currency codes and formats the fraud type codes for you. It knows exactly how to structure a counterfeit card report versus a stolen card alert. This cuts out the manual mapping work. Cascade reads your database schema and automatically writes the integration code to push these alerts to the MCP Server. It handles the exact payload structure required by the network, so your backend talks to the issuing banks correctly on the first try.
Map payment infrastructure
`search_places` finds merchants near GPS coordinates and checks if they accept contactless payments. You tell Cascade to build a local merchant finder. It hits the API, gets the latitude and longitude parameters right, and writes the React component. You watch it build the UI using live location data. `get_merchant` and `merchant_category_codes` pull the exact operating hours and business classifications. Cascade uses these tools to populate your frontend with actual details instead of lorem ipsum. You see the real API responses while you code, letting you catch edge cases before you compile.
Set up Mastercard MCP in Windsurf
Prerequisites
- Windsurf IDE installed (macOS, Windows, or Linux)
- Active Vinkius subscription with a valid endpoint token
- 1
Open MCP configuration
Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open
~/.codeium/windsurf/mcp_config.json. - 2
Add the Mastercard MCP
Paste the JSON snippet shown on the right into the
mcpServersobject. Replace[YOUR_TOKEN_HERE]with your endpoint token from cloud.vinkius.com. - 3
Refresh MCPs
Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
- 4
Verify in Cascade
Start a new Cascade conversation and ask something like "Show my Mastercard payment history." If connected, Cascade will call the Mastercard tools directly. You will see a green dot next to the server name in the MCP panel.
{
"mcpServers": {
"mastercard-mcp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}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.
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 Windsurf
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Mastercard MCP today
We host it, we monitor it, we maintain it. You just paste one token.
