Mastercard Developers Agent Toolkit

1 month ago 3
mastercard developers logo

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.

  • 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.

The toolkit provides the following tools for agents to use:

  • get-services-list: Lists all available Mastercard Developers Products and Services with their basic information including title, description, and service id.
  • 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-openfinance-integration-guide: Retrieves the comprehensive Open Finance integration guide.
  • 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.

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

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

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

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

Read Entire Article