# Mastercard Developers MCP

An MCP server that hands your agent Mastercard Developers docs, API specifications and OAuth guides. Useful when you are wiring up a Mastercard integration and want the right page without hunting for it.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 55
- Author: Mastercard
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Mastercard/developers-agent-toolkit/tree/HEAD/modelcontextprotocol
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/mastercard-developers-mcp

## What it does

The server sits between an MCP client and Mastercard Developers resources. Your agent can list the available services, pull operations out of an API specification with their request and response schemas, read documentation pages, and fetch the integration guides for OAuth 1.0a, OAuth 2.0 and Open Finance.

It starts with `npx -y @mastercard/developers-mcp` and talks over stdio. You can pin it to one service with the `--service` argument pointing at a documentation URL, or to a single spec via `--api-specification`. The spec argument wins over the service one, and setting either disables the `get-services-list` tool. So the agent loses the service listing once you narrow the scope.

Building from the repo needs Node.js 18+. The flow is `npm install`, then `npm run build`, then `npm run start`. To debug, run `npx @modelcontextprotocol/inspector node dist/index.js`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add developers-mcp -- npx -y @mastercard/developers-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add modelcontextprotocol -- npx -y @mastercard/developers-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "modelcontextprotocol": {
            "command": "npx",
            "args": [
                "-y",
                "@mastercard/developers-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "modelcontextprotocol": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mastercard/developers-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add modelcontextprotocol npx -y @mastercard/developers-mcp
```

## When to use it
- find a specific operation in a Mastercard API spec
- check request and response schemas before calling an endpoint
- walk through the OAuth 1.0a integration steps
- read a documentation section for one service
- list the products available on Mastercard Developers

## Example prompts
- List the Mastercard Developers services
- Show me the operations in `openbanking-us.yaml`
- Open the OAuth 2.0 integration guide for Mastercard APIs

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md