Access Mastercard Developers APIs, documentation, and API specifications through MCP.
Mastercard Developers MCP Server (io.github.Mastercard/developers-mcp)
The io.github.Mastercard/developers-mcp server provides access to Mastercard Developers APIs, documentation, and API specifications through the Model Context Protocol (MCP). It is described as enabling agent frameworks (currently MCP) to integrate with Mastercard Developers for service discovery and integration guides.
🛠️ Key Features
Access to Mastercard Developers APIs
Access to Mastercard Developers documentation
Access to Mastercard Developers API specifications
Service discovery integration with Mastercard Developers
Integration guides for MCP-based workflows
🚀 Use Cases
Building MCP-based agents that need Mastercard Developers API references
Discovering Mastercard services and using associated integration guides
Using the server from developer tooling ecosystems such as VS Code and Cursor
⚡ Developer Benefits
Consumes Mastercard Developers documentation and API specifications via MCP
Fits workflows involving LLM agents and agent frameworks
Suitable for TypeScript-based development workflows
⚠️ Limitations
Source material only confirms support for Model Context Protocol (MCP) as the “currently” integrated framework.
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/documentation
api-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 from Download Spec button in the API Reference page of service.
NOTE: Specifying this will override any value provided in service configuration.
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:
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.
You can also provide configuration options as arguments, see above for examples.
Development
Pre-requisites: Node.js 18+
Install dependencies:
bash
npm install
Build the project:
bash
npm run build
Run tests:
bash
npm run test
Start the server:
bash
npm run start
Watch for changes during development:
bash
npm run watch
The server runs on stdio and will be available for MCP client connections.
With Configuration Options
bash
# 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: