# Kueski Pay MCP for AI Agents AI Agent Connect > Kueski Pay MCP lets you manage Mexico's leading Buy Now, Pay Later (BNPL) platform directly through your AI agent. You can create checkout sessions, simulate quincena installment plans, process captures and refunds, and track merchant settlements without switching tabs or logging into a dashboard. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_epn0T4P1m1iTz0ckdyVM38bdYVkK2AANvXLJVA0z/ai-agent-connect - **Tags:** buy-now-pay-later, bnpl, installment-plans, checkout-automation, order-lifecycle, fintech ## Description Kueski Pay is Mexico's leading Buy Now, Pay Later platform, and this Connector lets you manage your entire merchant account through your AI agent. Instead of jumping between your merchant dashboard and your chat support tool, you can handle the entire payment lifecycle from one place. This connection lets your agent do the heavy lifting of managing installments. You can ask your agent to see if a customer's phone number is pre-approved for a loan or have it build out a payment plan for a specific product price. It handles the nitty-gritty stuff like finalizing payments once you ship an order or issuing a partial refund if something goes wrong. It even lets you keep an eye on your daily payouts and fees. Because Vinkius makes it so easy to plug this into your existing stack, you can actually give your support team the power to check credit limits or order statuses on the fly. It takes the manual work out of managing the Mexican BNPL market, letting you focus on moving products instead of chasing payment statuses. This setup is built for high volume merchants who need to move fast without the friction of manual data entry. By letting your agent handle the technical details of the Kueski Pay API, you turn a complex financial workflow into a simple conversation. ## Tools ### cancel_order This releases the credit hold on a customer's Kueski account. Use it to stop a pending order from processing. ### capture_order This finalizes the payment for an authorized order. Use it to move funds into your settlement queue when you ship items. ### check_eligibility This checks if a specific phone number is pre-approved for a loan. It helps you qualify customers instantly. ### create_order This generates a checkout URL for customers to complete their credit application. It starts the BNPL process. ### create_webhook This sets up real-time notifications for events like order approvals. It keeps your system updated automatically. ### get_customer_limits This pulls the current credit limits available to a customer. It's great for quick eligibility checks. ### get_merchant_profile This retrieves your current merchant account settings. Use it to verify your profile details. ### get_order This pulls the status and details of a specific BNPL order. Use it to see if a checkout was successful. ### get_settlement This pulls the details of a specific merchant payout. Use it to reconcile your daily fees. ### list_orders This shows a list of recent orders that you can filter by status. It's a fast way to see recent sales. ### list_settlements This displays a list of all merchant payout settlements. Use it to track your overall payouts. ### list_webhooks This shows all active webhook subscriptions. Use it to manage your real-time event listeners. ### refund_order This processes a refund for a captured order. It automatically adjusts the customer's payment schedule. ### simulate_installments This calculates interest rates and payment amounts for different quincena terms. Use it to show real pricing. ## Prompt Examples **Prompt:** ``` Can you check if phone number 55-1234-5678 is eligible for a $5,000 loan? ``` **Response:** ``` I've checked the eligibility for that number. **Phone 55-1234-5678 is PRE-APPROVED** for a BNPL loan of $5,000 MXN. They have an active Kueski Pay account in good standing. Would you like me to generate a checkout session for them now? ``` **Prompt:** ``` Show me the payment plans for a $3,500 jacket on Kueski Pay. ``` **Response:** ``` For a **$3,500 MXN** purchase, Kueski Pay offers these plans: | Plan Length | Interest | Payment per Fortnight | | :--- | :--- | :--- | | 4 Quincenas | 0% | $875 MXN | | 6 Quincenas | Variable | $625 MXN | | 8 Quincenas | Variable | $510 MXN | *Standard Kueski fees apply to plans over 4 quincenas.* ``` **Prompt:** ``` Capture order K-ABC-123 because the customer just received their package. ``` **Response:** ``` Order **K-ABC-123** has been successfully captured. The full amount of **$2,100 MXN** is now in the settlement queue. The customer's first quincena payment will be due in 15 days. ``` ## Capabilities ### Create BNPL checkout sessions Generate unique URLs for customers to complete their credit applications. ### Simulate quincena payment plans Calculate interest rates and installment amounts for specific purchase prices. ### Capture full or partial order funds Move authorized funds into your settlement queue once items are shipped. ### Issue full or partial refunds Process refunds and automatically adjust the customer's remaining payment schedule. ### Check customer credit eligibility Verify if a phone number is pre-approved for a BNPL loan instantly. ### Track merchant payout settlements Query daily settlement batches and fees to reconcile your payouts. ### Manage webhook subscriptions Set up real-time notifications for order approvals, declines, and refunds. ## Use Cases ### Checking customer loan eligibility A support agent needs to know if a customer's phone number is pre-approved for a loan. They ask the agent to check_eligibility for a $5,000 cart. ### Simulating dynamic pricing for a product page A developer wants to show the cost of a jacket in 4 vs 8 quincenas. They ask the agent to use simulate_installments for a $3,500 MXN price. ### Processing a refund for a shipped item A customer returns a product. The manager asks the agent to use refund_order to process the return and update the payment plan. ### Capturing funds after shipment An order is marked as shipped in the warehouse. The manager asks the agent to use capture_order to finalize the payment. ### Reconciling daily payouts At the end of the day, the accountant asks the agent to list_settlements to see the total payout and fees for the batch. ## Benefits - Stop manual data entry by using create_order to generate checkout links automatically for every new sale. - Give support teams instant answers by using get_customer_limits to check credit status during live conversations. - Simplify your fulfillment process by using capture_order to move funds into your queue the moment an item ships. - Provide accurate pricing to your customers by using simulate_installments to show real quincena costs on your site. - Keep your records perfectly clean by using refund_order to automatically adjust a customer's payment schedule. - Stay on top of your revenue without checking the dashboard by using list_orders and list_settlements for a quick summary. ## How It Works The bottom line is it puts your entire Kueski Pay merchant account under your AI agent's control. 1. Connect your Kueski Pay API credentials to the Connector. 2. Link the Connector to your preferred client like Claude, Cursor, or Windsurf. 3. Start asking your agent to manage orders, simulate payments, or check customer eligibility. ## Frequently Asked Questions **Can I use Kueski Pay to manage my BNPL store?** Yes, this Connector connects your Kueski Pay merchant account to your AI agent. It allows you to manage the entire lifecycle of Buy Now, Pay Later orders directly from your workspace. **How do I check customer credit with Kueski Pay?** You can simply ask your agent to check the eligibility of a customer's phone number. The Connector will instantly return whether they are pre-approved and for what amount. **Can my AI agent process Kueski Pay refunds?** Absolutely. Your agent can process full or partial refunds for captured orders. It will also automatically adjust the customer's remaining quincena payment schedule. **Does Kueski Pay support quincena simulations?** Yes, the Connector can calculate and display various quincena payment terms, including interest rates and estimated payment amounts for different purchase prices. **How do I see my Kueski Pay settlement history?** You can ask your agent to list your merchant payout settlements. It will pull the details of your daily batches and fees so you can reconcile your payouts easily. **Can I use Kueski Pay for my Mexican e-commerce site?** Yes, this is specifically designed for merchants using Kueski Pay in Mexico. It helps you offer BNPL options and manage the resulting orders through an AI-powered workflow. **How do I simulate the installment plan (quincenas) pricing for a product?** Use the `simulate_installments` tool and pass the product's price in MXN. It will return all available payment plans (e.g., 4, 6, 8 quincenas), showing the exact amount the customer would pay every two weeks. **Can I process a partial refund for an order that has already been captured?** Yes! Use the `refund_order` tool with the order ID and the desired refund amount. Kueski will automatically adjust the customer's remaining installment payments to reflect the new, lower balance. **What does capture_order do in BNPL?** When a customer finishes checkout, the order is authorized (funds are held). You must call `capture_order` when you actually ship or fulfill the items. If you don't capture within the expiration window (usually 14 days), the temporary authorization is released.