https://github.com/mastercard/developers-agent-toolkit
The Mastercard Developers Agent Toolkit allows popular agent frameworks to integrate with Mastercard Developers Platform for service discovery and integration guides.
https://github.com/mastercard/developers-agent-toolkit
Last synced: 11 months ago
JSON representation
The Mastercard Developers Agent Toolkit allows popular agent frameworks to integrate with Mastercard Developers Platform for service discovery and integration guides.
- Host: GitHub
- URL: https://github.com/mastercard/developers-agent-toolkit
- Owner: Mastercard
- License: mit
- Created: 2025-07-22T18:17:48.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-07T15:21:58.000Z (12 months ago)
- Last Synced: 2025-08-07T15:39:06.494Z (12 months ago)
- Language: TypeScript
- Size: 736 KB
- Stars: 6
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mastercard Developers Agent Toolkit
The Mastercard Developers Agent Toolkit allows popular agent frameworks (currently Model Context Protocol - MCP) to integrate with [Mastercard Developers Platform](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-openbanking-integration-guide`: Retrieves the comprehensive Open Banking 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.