The Yuno Payments MCP server acts as a digital bridge between the Yuno payment ecosystem and AI-powered coding assistants. It allows developers to interact with their payment systems as easily as they chat with an AI, making it simple to manage customers and transactions without manually digging through API documentation. By turning complex payment tasks into natural language commands, this tool helps teams move faster when building or maintaining financial workflows. Designed for seamless integration with platforms like Claude Desktop and Cursor, this package exposes a variety of Yuno API endpoints as Model Context Protocol tools. Once connected, an AI agent gains the ability to programmatically create checkout sessions, register new customers, and check payment statuses on behalf of the developer. It simplifies the development process by leveraging a straightforward TypeScript environment, ensuring that financial operations are both accessible and scriptable within a modern development workspace. For developers building sophisticated automation, this server is particularly powerful because it allows an LLM to act as an autonomous agent for complex billing scenarios. By providing the AI with structured access to essential credentials—such as account codes and private secret keys—through secure environment variables, the tool enables advanced logic and real-time execution. This setup transforms a standard AI assistant into a functional participant in the development lifecycle, capable of executing real-world financial operations and troubleshooting payment logic with minimal manual intervention.
1. Installation You can either build the project locally or run it directly using npx. Building Locally:bash git clone https://github.com/yuno-payments/yuno-mcp.git cd yuno-mcp npm install npm run buildDirect Execution: The server can be run without manual installation using: npx @yuno-payments/yuno-mcp@latest ---
2. Configuration
Required Environment Variables To use this server, you must provide the following environment variables: * YUNO_ACCOUNT_CODE * YUNO_PUBLIC_API_KEY * YUNO_PRIVATE_SECRET_KEY * YUNO_COUNTRY_CODE (Optional) * YUNO_CURRENCY (Optional)
Claude Desktop Configuration Add this to your Claude Desktop configuration file: json { "mcpServers": { "yuno-mcp": { "command": "npx", "args": [ "@yuno-payments/yuno-mcp@latest" ], "env": { "YUNO_ACCOUNT_CODE": "your_account_code", "YUNO_PUBLIC_API_KEY": "your_public_api_key", "YUNO_PRIVATE_SECRET_KEY": "your_private_secret_key", "YUNO_COUNTRY_CODE": "your_country_code", "YUNO_CURRENCY": "your_currency" } } } }
Cursor Configuration In Cursor Settings > MCP > Add new global MCP server, use the following: json { "mcpServers": { "yuno-mcp": { "type": "command", "command": "npx @yuno-payments/yuno-mcp@latest", "env": { "YUNO_ACCOUNT_CODE": "your_account_code", "YUNO_PUBLIC_API_KEY": "your_public_api_key", "YUNO_PRIVATE_SECRET_KEY": "your_private_secret_key", "YUNO_COUNTRY_CODE": "your_country_code", "YUNO_CURRENCY": "your_currency" } } } } ---
3. Available Tools The server exposes Yuno API endpoints as Model Context Protocol tools, allowing the AI to perform the following actions: * Payments: Create and manage payments programmatically. * Customers: Create and manage customer profiles. * Checkouts: Create and manage checkout sessions. ---
4. Example Prompts You can use the following types of requests with your AI assistant: * "Create a payment using the yuno-mcp tool." * "Create a new customer in Yuno." * "Start a checkout session for a customer." * "Manage my Yuno payments and checkouts programmatically."
What you can do with Yuno Payments
Use Case 1: Rapid E-commerce Prototyping in Cursor Problem: Developers building a new online store often spend hours writing boilerplate code to integrate payment gateways, create checkout sessions, and handle customer data. Manually consulting API documentation and writing the integration logic is time-consuming and prone to syntax errors. Solution: By using the Yuno Payments MCP within the Cursor IDE, a developer can simply prompt the AI to "Implement a checkout flow using Yuno." The AI agent uses its direct access to the Yuno tools to generate the correct API calls, set up the checkout session parameters, and verify the implementation against the actual API schema in real-time. Example: A developer says: "Create a script that generates a Yuno checkout session for a $50 product and returns the redirect URL." Cursor uses the yuno-mcp to generate the code and can even execute a test call to ensure the configuration is correct.
Use Case 2: AI-Powered Customer Support Payment Tracking Problem: Customer support representatives often have to switch between multiple tabs and dashboards to find a customer’s payment status or update their billing information, leading to slow response times and potential data entry errors. Problem: With the Yuno MCP integrated into Claude Desktop, a support agent can manage payments through a natural language interface. They can quickly query transaction histories or create new customer profiles without leaving the chat window. Example: A support rep types: "Find the payment status for customer 'johndoe@example.com' and tell me if the transaction from this morning was successful." The AI agent calls the Yuno API via the MCP, retrieves the record, and summarizes the status for the rep instantly.
Use Case 3: Automated Customer Onboarding and Billing Setup Problem: When a new enterprise client signs up, operations teams often have to manually create customer records in the payment provider's system to prepare for future invoicing or subscription management. Solution: This MCP allows for the creation of automated workflows where an AI agent (like a Claude-powered Slack bot or internal tool) listens for a "New Client" trigger and automatically uses the Yuno MCP to create a customer profile and store their billing details. Example: An automation script detects a new entry in a CRM. It triggers an AI agent which uses the yuno-mcp tool to "Create a new customer in Yuno with name 'Acme Corp' and country code 'US'," ensuring the payment infrastructure is ready…