Access Mastercard service lists, API specifications, documentation, and integration guides for OAuth and Open Finance through an AI client.
Also known as Mastercard/developers-agent-toolkit, developers-mcp, @mastercard/developers-mcp
- Stars
- 60
- Tools
- 9
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Oct 1, 2026
- License
- MIT
What is Mastercard Developers MCP?
Mastercard Developers accesses Mastercard service lists, API specifications, documentation, and integration guides for OAuth and Open Finance through an AI client. It exposes 9 tools, such as get-services-list, get-documentation, get-documentation-section-content.
Summary generated from the project's README
About Mastercard Developers MCP server
Developers building financial applications can access Mastercard technical resources directly through an AI client. This server connects your agent to the Mastercard Developers platform, allowing it to browse available products and retrieve specific technical details without manual searching. It works via stdio and can be integrated into Claude Desktop or VS Code using npx.
Users can explore the full catalog using the get-services-list tool or focus on a specific area by providing a service URL or an API specification via configuration arguments. The server provides deep technical insights through tools like get-api-operation-details for request and response schemas, and get-documentation-page for reading full guides. It is specifically designed to help engineers navigate complex authentication and implementation requirements.
Beyond simple service discovery, the server includes dedicated tools for retrieving integration guides for OAuth 1.0a, OAuth 2.0, and Open Finance. This allows an AI assistant to provide step-by-step instructions and code examples for setting up secure connections to Mastercard APIs.
What you can do with it
- 1Discover available Mastercard servicesAsk the AI to list all available Mastercard products and their descriptions to find a suitable service.
- 2Analyze API request and response schemasRequest detailed technical specifications for a specific API endpoint to understand required parameters.
- 3Implement secure authentication flowsAsk for a step-by-step guide on how to integrate OAuth 2.0 into a new application.
- 4Research Open Finance implementationGet setup instructions and usage examples for Open Finance integration.
Written from the project's README. Every use case is checked against a quote from it.
How to install Mastercard Developers MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Mastercard Developers MCP in Claude Code
$ claude mcp add developers-mcp -- npx -y @mastercard/developers-mcpInstall Mastercard Developers MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"developers-mcp": {
"command": "npx",
"args": [
"-y",
"@mastercard/developers-mcp"
]
}
}
}Install Mastercard Developers MCP in VS Code
.vscode/mcp.json
{
"servers": {
"developers-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mastercard/developers-mcp"
]
}
}
}Install Mastercard Developers MCP in VS Code CLI
$ code --add-mcp '{"name":"developers-mcp","type":"stdio","command":"npx","args":["-y","@mastercard/developers-mcp"]}'Install Mastercard Developers MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"developers-mcp": {
"command": "npx",
"args": [
"-y",
"@mastercard/developers-mcp"
]
}
}
}Install Mastercard Developers MCP in Codex
$ codex mcp add developers-mcp -- npx -y @mastercard/developers-mcpInstall Mastercard Developers MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.developers-mcp] command = "npx" args = ["-y", "@mastercard/developers-mcp"]
Install Mastercard Developers MCP in Gemini CLI
$ gemini mcp add -s user developers-mcp npx -- -y @mastercard/developers-mcpInstall Mastercard Developers MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"developers-mcp": {
"command": "npx",
"args": [
"-y",
"@mastercard/developers-mcp"
]
}
}
}Mastercard Developers MCP tools 9
Detected from the READMEget-services-listget-documentationget-documentation-section-contentget-documentation-pageget-api-operation-listget-api-operation-detailsget-oauth10a-integration-guideget-oauth20-integration-guideget-openfinance-integration-guide
| get-services-list | — | |
| get-documentation | — | |
| get-documentation-section-content | — | |
| get-documentation-page | — | |
| get-api-operation-list | — | |
| get-api-operation-details | — | |
| get-oauth10a-integration-guide | — | |
| get-oauth20-integration-guide | — | |
| get-openfinance-integration-guide | — |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubMastercard Developers MCP Server
A Model Context Protocol (MCP) server that provides access to Mastercard Developers documentation.
Overview
This MCP server acts as a bridge between MCP clients and Mastercard Developers resources, offering tools to:
- List available Mastercard services
- Query API specifications and their operations
- Access documentation for each service
- Retrieve integration guides for OAuth 1.0a, OAuth 2.0, and Open Finance
Available Tools
Service Discovery
get-services-list: Lists all available Mastercard Developers Products and Services with their basic information including title, description, and service ID.
Documentation
-
get-documentation: Provides an overview of all available documentation for a specific Mastercard service including section titles, descriptions, and navigation links. -
get-documentation-section-content: Retrieves the complete content for a specific documentation section. -
get-documentation-page: Retrieves the complete content of a specific documentation page.
API Operations
-
get-api-operation-list: Provides a summary of all API operations for a specific Mastercard API specification including HTTP methods, request paths, titles, and descriptions. -
get-api-operation-details: Provides detailed information about a specific API operation including parameter definitions, request and response schemas, and technical specifications for successful API calls.
Integration Guides
-
get-oauth10a-integration-guide: Retrieves the comprehensive OAuth 1.0a integration guide including step-by-step instructions, code examples, and best practices for Mastercard APIs. -
get-oauth20-integration-guide: Retrieves the comprehensive OAuth 2.0 integration guide including step-by-step instructions, code examples, and best practices for Mastercard APIs. -
get-openfinance-integration-guide: Retrieves the comprehensive Open Finance integration guide including setup instructions, API usage examples, and implementation best practices.
Configuration Options
You can pre-configure the server with a specific service or API specification by passing them as arguments. This is useful when you are working with a specific service, and you want to focus your agents
service: URL of the documentation of a service that you want the MCP to focus on e.g.https://developer.mastercard.com/mdes-customer-service/documentationapi-specification: URL of the API specification that you want the MCP tools to focus on e.g.https://static.developer.mastercard.com/content/match/swagger/match-pro.yaml. You can get the link fromDownload Specbutton in theAPI Referencepage of service. NOTE: Specifying this will override any value provided inserviceconfiguration.
If you specify service or api-specification then the get-services-list tool will be disabled.
Integration with MCP Clients
To use this server with MCP clients like Claude Desktop, add it to your MCP configuration:
{
"mcpServers": {
"mastercard-developers": {
"command": "npx",
"args": ["-y", "@mastercard/developers-mcp"]
}
}
}
For Specific Service
{
"mcpServers": {
"mastercard-developers": {
"command": "npx",
"args": [
"-y",
"@mastercard/developers-mcp",
"--service=https://developer.mastercard.com/open-finance-us/documentation/"
]
}
}
}
For Specific API Specification
{
"mcpServers": {
"mastercard-developers": {
"command": "npx",
"args": [
"-y",
"@mastercard/developers-mcp",
"--api-specification=https://developer.mastercard.com/open-finance-us/swagger/openbanking-us.yaml"
]
}
}
}
Usage with VSCode
For quick installation, use one of the one-click installation buttons below:
For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open Settings (JSON).
Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.
Note that the mcp key is not needed in the .vscode/mcp.json file.
NPX
{
"mcp": {
"servers": {
"mastercard-developers": {
"command": "npx",
"args": ["-y", "@mastercard/developers-mcp"]
}
}
}
}
You can also provide configuration options as arguments, see above for examples.
Development
Pre-requisites: Node.js 18+
-
Install dependencies:
npm install -
Build the project:
npm run build -
Run tests:
npm run test -
Start the server:
npm run start
Watch for changes during development:
npm run watch
The server runs on stdio and will be available for MCP client connections.
With Configuration Options
# Pre-configure with a documentation URL
npm run start -- --service=https://developer.mastercard.com/open-finance-us/documentation/
# Pre-configure with an API specification path
npm run start -- --api-specification=https://static.developer.mastercard.com/content/open-finance-us/swagger/openbanking-us.yaml
To build the DXT file
You can build the DXT file for one-click installation for Claude Desktop by running:
npm run build-dxt
Debugging the server
npx @modelcontextprotocol/inspector node dist/index.js
References
Mastercard Developers MCP questions
How do I add Mastercard Developers MCP to Claude Code?
Run claude mcp add developers-mcp -- npx -y @mastercard/developers-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Mastercard Developers MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Mastercard Developers MCP provide?
It exposes 9 tools, including get-services-list, get-documentation, get-documentation-section-content, get-documentation-page, get-api-operation-list.
What can I do with the Mastercard Developers MCP server?
It allows you to list available Mastercard services, query API specifications and operations, access documentation, and retrieve integration guides for OAuth and Open Finance.
How do I install the server for use in Claude Desktop?
You can add the server to your MCP configuration by using the npx command with the @mastercard/developers-mcp package.