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.

Related MCP server: Swagger/OpenAPI MCP Server

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

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.