@mastercard/developers-mcp
Version:
MCP server for Mastercard Developers Platform
196 lines (137 loc) • 6.57 kB
Markdown
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://developer.mastercard.com/_/_/src/global/assets/svg/mcdev-logo-light.svg">
<img src="https://developer.mastercard.com/_/_/src/global/assets/svg/mcdev-logo-dark.svg" alt="mastercard developers logo">
</picture>
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 and Open Banking
## 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-openbanking-integration-guide`**: Retrieves the comprehensive Open Banking 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:
```json
{
"mcpServers": {
"mastercard-developers": {
"command": "npx",
"args": ["-y", "@mastercard/developers-mcp"]
}
}
}
```
**For Specific Service**
```json
{
"mcpServers": {
"mastercard-developers": {
"command": "npx",
"args": [
"-y",
"@mastercard/developers-mcp",
"--service=https://developer.mastercard.com/open-banking-us/documentation/"
]
}
}
}
```
**For Specific API Specification**
```json
{
"mcpServers": {
"mastercard-developers": {
"command": "npx",
"args": [
"-y",
"@mastercard/developers-mcp",
"--api-specification=https://developer.mastercard.com/open-banking-us/swagger/openbanking-us.yaml"
]
}
}
}
```
For quick installation, use one of the one-click installation buttons below:
[](https://insiders.vscode.dev/redirect/mcp/install?name=mastercard-developers&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40mastercard%2Fdevelopers-mcp%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=mastercard-developers&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40mastercard%2Fdevelopers-mcp%22%5D%7D&quality=insiders)
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
```json
{
"mcp": {
"servers": {
"memory": {
"command": "npx",
"args": ["-y", "@mastercard/developers-mcp"]
}
}
}
}
```
You can also provide configuration options as arguments, see above for examples.
Pre-requisites: Node.js 18+
1. Install dependencies:
```bash
npm install
```
2. Build the project:
```bash
npm run build
```
3. Run tests:
```bash
npm run test
```
4. 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.
```bash
npm run start -- --service=https://developer.mastercard.com/open-banking-us/documentation/
npm run start -- --api-specification=https://static.developer.mastercard.com/content/open-banking-us/swagger/openbanking-us.yaml
```
You can build the [DXT](https://github.com/anthropics/dxt) file for one-click installation for Claude Desktop by running:
```bash
npm run build-dxt
```
```bash
npx @modelcontextprotocol/inspector node dist/index.js
```
- [Mastercard Developers Platform](https://developer.mastercard.com/)
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [MCP SDK](https://github.com/modelcontextprotocol/sdk)