# Mastercard Developers Agent Toolkit

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

The Mastercard Developers Agent Toolkit allows popular agent frameworks (currently Model Context Protocol - MCP) to integrate with [Mastercard Developers](https://developer.mastercard.com) 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.

```bash
npx -y @mastercard/developers-mcp
```

For more details for the configuration options, see [modelcontextprotocol](modelcontextprotocol/README.md) directory

### Installation

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

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

Requirements
- Node 18+

```javascript
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](typescript/README.md) 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](LICENSE) file for details.