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.
Category: Developer Tools & Code Intelligence
Tags: billing, fintech, payments, transactions, yuno
npx. Building Locally: bash git clone https://github.com/yuno-payments/yuno-mcp.git cd yuno-mcp npm install npm run build Direct Execution: The server can be run without manual installation using: npx @yuno-payments/yuno-mcp@latest ---YUNO_ACCOUNT_CODE * YUNO_PUBLIC_API_KEY * YUNO_PRIVATE_SECRET_KEY * YUNO_COUNTRY_CODE (Optional) * YUNO_CURRENCY (Optional)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" } } } }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" } } } } ---yuno-mcp to generate the code and can even execute a test call to ensure the configuration is correct.yuno-mcp tool to "Create a new customer in Yuno with name 'Acme Corp' and country code 'US'," ensuring the payment infrastructure is ready…Part of MCP Servers
You can run the server directly using npx by specifying the package @yuno-payments/yuno-mcp@latest inside your MCP client settings file. Alternatively, you can clone the repository from GitHub, install dependencies with npm, build the TypeScript files locally, and point your client configuration to the built executable.
The server exposes Yuno payment endpoints as standard MCP tools. It allows connected AI assistants to create and manage customer profiles, initiate checkout sessions, generate payment links, and query transaction statuses directly from a natural language interface or IDE.
It functions with any MCP-compliant client that supports standard stdio transport or command-line execution, including Claude Desktop and the Cursor IDE. You configure the server under your client settings by setting the execution command and providing required Yuno environment variables.
You must provide your Yuno account code, public API key, and private secret key via environment variables. You can also specify an optional country code and default currency to streamline transaction creation.