How to Use the Mastercard MCP in CrewAI

Q: How do I assign Mastercard tools to specific CrewAI agents?

You can pass the MCP Server URL directly in the mcps array when defining your agents. This allows you to give the submitfraudreport tool exclusively to your compliance agent while keeping research tools open to others.

Q: Can I limit which Mastercard tools my agents can access?

Yes, you can use the toolfilter option with MCPServerHTTP to restrict tool access. This ensures that only authorized agents can see or execute sensitive actions like account validation.

Run multi-agent teams to handle autonomous fraud monitoring and merchant mapping with Mastercard and CrewAI.

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 CrewAI

Create your Vinkius account to connect Mastercard to CrewAI 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Fraud Detection Teams

Deploy a crew of specialized agents to monitor and flag fraudulent transactions without human intervention. By connecting this Mastercard MCP Server to CrewAI, you can set up a researcher agent to analyze card profiles and a compliance agent to file reports. The researcher uses `bin_lookup` to check the issuing bank and country of suspicious accounts. If the transaction looks compromised, the compliance agent steps in to run `submit_fraud_report` automatically. This collaborative approach ensures that your security operations run twenty-four-seven, using shared memory to cross-reference previous fraud patterns before taking action.

Multi-Agent Merchant Intelligence Crews

Build autonomous research teams that map out local business markets. Your CrewAI lead agent can coordinate a search using `search_merchants` and `nearby_locations` to gather raw business listings. A second analyst agent then takes over to pull details for each location using `get_merchant`. The agents work sequentially to build a complete profile of merchant options in any given area. By parsing data from `merchant_category_codes`, the crew can automatically filter out irrelevant businesses and present a curated list of target accounts to your CRM.

Automated Payment Location Auditing with CrewAI

Let your AI agents audit retail accepting locations using street addresses. By connecting this MCP Server to your crew, a geocoding agent uses `search_places_by_address` to find physical storefronts, while a verification agent checks their payment capabilities. They work together to confirm if stores accept contactless options or mobile wallets. The crew queries `get_place_details` to verify exact payment features like Apple Pay or Google Pay support. This multi-agent setup is perfect for keeping your merchant directories accurate, running background audits without tying up your development team.

Setup guide

Set up Mastercard MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Mastercard tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Mastercard Analyst",
    goal="Access and analyze Mastercard data via MCP.",
    backstory="Expert analyst with direct Mastercard access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Mastercard transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Mastercard Analyst",
        goal="Access and analyze Mastercard data via MCP.",
        backstory="Expert analyst with direct Mastercard access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Mastercard transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

You can pass the MCP Server URL directly in the `mcps` array when defining your agents. This allows you to give the `submit_fraud_report` tool exclusively to your compliance agent while keeping research tools open to others.

Yes, CrewAI features a shared memory system that lets agents pass data directly. A research agent can run `bin_lookup` and pass the bank issuer metadata to an analysis agent without needing to hit the API a second time.

Your agents use sequential tasks to query coordinates and street addresses. One agent runs `search_places` to find locations, and the next agent immediately picks up the resulting IDs to pull full profiles via `get_place_details`.

Yes, you can use the `tool_filter` option with `MCPServerHTTP` to restrict tool access. This ensures that only authorized agents can see or execute sensitive actions like account validation.

This MCP Server runs in a zero-trust V8 sandbox that isolates all transaction payloads. CrewAI agents process transaction amounts and currency codes in memory, ensuring that sensitive financial data used in `submit_fraud_report` is never cached or written to disk.

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