How do I install Mastercard Developers MCP?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Mastercard Developers MCP need an API key?

No required environment variable is listed on this record.

What transport does Mastercard Developers MCP use?

Mastercard Developers MCP runs locally over stdio.

When was Mastercard Developers MCP last checked?

Last checked 2026-11-09. Access Mastercard Developers APIs, documentation, and API specifications through MCP.

Mastercard Developers MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @mastercard/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.mastercard-developers-mcp -- npx -y @mastercard/developers-mcp@0.1.5

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.mastercard-developers-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@mastercard/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Mastercard Developers Agent Toolkit

The Mastercard Developers Agent Toolkit allows popular agent frameworks (currently Model Context Protocol - MCP) to integrate with Mastercard Developers for service discovery and integration guides.

Key Features

Service Discovery: Enables agents to programmatically discover available services on the Mastercard Developers platform.
Integration Guide Access: Provides access to detailed documentation and integration guides.
Flexible Deployment: Can be run as a standalone server or integrated as a library in TypeScript/JavaScript projects.
MCP-Based: Built on the Model Context Protocol (MCP) for standardized communication.

Supported Tool Calls

The toolkit provides the following tools for agents to use:

Services

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.
get-oauth10a-integration-guide: Retrieves the comprehensive OAuth 1.0a integration guide.
get-oauth20-integration-guide: Retrieves the comprehensive OAuth 2.0 integration guide.
get-openfinance-integration-guide: Retrieves the comprehensive Open Finance integration guide.

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.

Model Context Protocol

We provide a standalone Model Context Protocol (MCP) server that can be used with MCP clients.

npx -y @mastercard/developers-mcp

For more details for the configuration options, see modelcontextprotocol directory

Installation

If you want to use the package in your project, you can install it using npm:

npm install --save @mastercard/developers-agent-toolkit

Requirements

Node 18+

import { MastercardDevelopersAgentToolkit } from "@mastercard/developers-agent-toolkit/mcp";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new MastercardDevelopersAgentToolkit({});

async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.error("Mastercard Developers MCP Server running on stdio");
}

main().catch((error) => {
  console.error("Fatal error in main():", error);
  process.exit(1);
});

For more details, checkout typescript directory

Agent Plugins

Agent skills are instructions that agents can use to build faster and more accurately. This repository provides official plugins that bundle the mastercard-best-practices skill together with the Mastercard Developers MCP server for popular agent harnesses.

If you use one of these harnesses, we recommend installing the plugin, which includes the MCP server and updates automatically.

Note: The curated marketplace commands below (@claude-plugins-official, @openai-curated, and the Cursor slash command) work once the plugin is accepted into each vendor's registry. Until then, use the GitHub-based install shown under Install from this repository.

Claude Code

claude plugin install mastercard-developers@claude-plugins-official

Codex

codex plugin add mastercard-developers@openai-curated

Cursor

/add-plugin mastercard-developers

Manual installation

Manually installed skills don't auto-update. Run npx skills update -y to get the latest versions.

npx skills add Mastercard/developers-agent-toolkit

Install from this repository

Before the plugins are listed in the curated marketplaces, you can install directly from this GitHub repository.

Claude Code - add this repo as a marketplace, then install:

claude plugin marketplace add Mastercard/developers-agent-toolkit
claude plugin install mastercard-developers@mastercard-developers

Skills only (any supported agent) - install the skill straight from the repo:

npx skills add Mastercard/developers-agent-toolkit

Plugin sources live under providers/, and the marketplace manifests are .claude-plugin/marketplace.json, .codex-plugin/marketplace.json, and .cursor-plugin/marketplace.json.

Using the skill

Once the plugin (or MCP server) is installed, just prompt your agent in plain language. The skill guides the agent to call the Mastercard Developers MCP tools instead of relying on training data.

Try a prompt like:

Using the Mastercard Developers tools, list the available services,
then show me the API operations for the Mastercard Locations API and
explain how to authenticate with OAuth 1.0a.

Prompting the agent with the Mastercard Developers skill

Results will include the service list, the API operations for the Locations API, and details about the OAuth 1.0a integration:

Service list and Locations API operations returned by the agent

OAuth 1.0a integration details returned by the agent

Behind the scenes the agent chains the MCP tools to answer this, for example:

get-services-list - discover available Mastercard products/services.
get-api-operation-list - list operations for the chosen service's spec.
get-documentation-page - discover the correct swagger spec path.
get-oauth10a-integration-guide - pull the official authentication guide.

You don't call these tools directly - just describe your goal and the agent selects the right tools.

Editing skills

The skills/ directory at the repository root is the single source of truth for every agent skill (for example mastercard-best-practices). Each provider under providers/*/plugin/skills/ holds a synchronized copy - do not edit those copies directly.

To update a skill:

Edit the canonical file under skills/ (e.g. skills/mastercard-best-practices/SKILL.md).
Run the sync script from the repository root to propagate the change to every provider:
```
node scripts/sync.js
```

To verify (without writing) that the provider copies match the canonical source - useful in CI or a pre-commit hook - run:

node scripts/sync.js --check

This exits non-zero if any provider skill is missing or out of sync.

Contributing

Contributions are welcome. Please feel free to submit a pull request or open an issue to report a bug or suggest a feature.

License

This project is licensed under the MIT License. See the LICENSE file for details.