@yuno-payments/yuno-mcp

MCP server exposing the Yuno API as Model Context Protocol (MCP) tools

This package provides an MCP server that exposes the Yuno payment platform API as Model Context Protocol tools, enabling programmatic access for AI agents, automation, and advanced workflows.

https://github.com/user-attachments/assets/8f41f3d7-5c52-4d8c-a5fd-681d6ab54b75

Features

• Exposes Yuno API endpoints as MCP tools
• Enables AI and automation workflows with Yuno
• TypeScript support
• Easy integration with Cursor and other MCP-compatible agents

Using with Cursor or Claude Desktop

You can use this MCP server with Cursor or Claude Desktop to enable AI-driven payment flows, customer creation, and more.

Prerequisites

• For Local MCP Server: Node.js (version 18 or higher) must be installed on your system
• For Remote MCP Server: No additional software required

1. Set Up Your Yuno API Credentials

• Set your Yuno API credentials using environment variables (see config examples below).

2. Add the MCP Server to Cursor

1. Open Cursor Settings (Cmd+Shift+P → "Cursor Settings").
2. Go to the "MCP" section and click "Add new global MCP server".
3. Add the following config (replace the path with your actual build output):

{
    "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"
            }
        }
    }
}

3. Add the MCP Server to Claude Desktop

1. Open Claude Desktop settings → "Developer" tab → Edit Config.
2. Add the following config:

{
    "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"
            }
        }
    }
}

4. Using Remote MCP Server (Alternative)

Instead of running the MCP server locally, you can use the remote MCP server hosted by Yuno. This is useful when you don't want to manage the server locally or for production environments.

For Cursor:

{
    "mcpServers": {
        "yuno-mcp": {
            "type": "http",
            "url": "https://y.uno/yuno-mcp/mcp",
            "headers": {
                "public-api-key": "your_public_api_key",
                "private-secret-key": "your_private_secret_key",
                "account-code": "your_account_code"
            }
        }
    }
}

For Claude Desktop:

{
    "mcpServers": {
        "yuno-mcp": {
            "url": "https://y.uno/yuno-mcp/mcp",
            "headers": {
                "public-api-key": "your_public_api_key",
                "private-secret-key": "your_private_secret_key",
                "account-code": "your_account_code"
            }
        }
    }
}

5. Test the Integration

• In Cursor or Claude, select a Markdown file or chat and ask the agent to create a payment, customer, or checkout session using the yuno-mcp tool.
• Make sure your environment variables are set correctly.

Required environment variables:

• YUNO_ACCOUNT_CODE
• YUNO_PUBLIC_API_KEY
• YUNO_PRIVATE_SECRET_KEY

Available Tools

The Yuno MCP server exposes the following tools for AI agents and automation:

| Tool Name | Description | | --------------------------------------- | ------------------------------------------------------------------------------ | | customerCreate | Create a new customer | | customerRetrieve | Retrieve a customer by ID | | customerRetrieveByExternalId | Retrieve a customer by external id (merchant_customer_id) | | customerUpdate | Update an existing customer by ID | | paymentMethodEnroll | Enroll or create payment method for a customer. | | paymentMethodRetrieve | Retrieve payment method. | | paymentMethodRetrieveEnrolled | Retrieve all enrolled payment methods for a customer. | | paymentMethodUnenroll | Unenroll payment method. | | checkoutSessionCreate | Create a checkout session | | checkoutSessionCreateOtt | Generate a One Time Token (OTT) for a checkout session | | checkoutSessionRetrievePaymentMethods | Retrieve payment methods for checkout | | paymentCreate | Create a payment with various workflows | | paymentRetrieve | Retrieve payment information | | paymentRetrieveByMerchantOrderId | Retrieve payment(s) by merchant_order_id | | paymentRefund | Refund a payment (full or partial) by payment and transaction id | | paymentCancelOrRefund | Cancel or refund a payment by payment id (auto-detects action) | | paymentCancelOrRefundWithTransaction | Cancel or refund a payment by payment and transaction id (auto-detects action) | | paymentCancel | Cancel a pending payment by payment and transaction id | | paymentAuthorize | Authorize a payment (capture: false) | | paymentCaptureAuthorization | Capture a previously authorized payment | | paymentLinkCreate | Create a new payment link | | paymentLinkRetrieve | Retrieve a payment link by ID | | paymentLinkCancel | Cancel a payment link by ID | | subscriptionCreate | Create a new subscription | | subscriptionRetrieve | Retrieve a subscription by ID | | subscriptionPause | Pause a subscription by ID | | subscriptionResume | Resume a subscription by ID | | subscriptionUpdate | Update a subscription by ID | | subscriptionCancel | Cancel a subscription by ID | | recipientCreate | Create a new recipient | | recipientRetrieve | Retrieve a recipient by ID | | recipientUpdate | Update a recipient by ID | | recipientDelete | Delete a recipient by ID | | installmentPlanCreate | Create a new installment plan | | installmentPlanRetrieve | Retrieve an installment plan by ID | | installmentPlanRetrieveAll | Retrieve all installment plans for an account | | installmentPlanUpdate | Update an installment plan by ID | | installmentPlanDelete | Delete an installment plan by ID | | documentationRead | Access Yuno API documentation and guides |

Payment Workflows

The paymentsCreate tool supports three workflow types:

• DIRECT - Direct payment processing
• REDIRECT - Redirect-based payment flow
• SDK_CHECKOUT - Requires checkout_session_id and ott (for web, android, and ios payments)