# Clip API MCP for AI Agents AI Agent Connect > Clip API lets you automate Mexico's leading payment gateway. You can generate payment links, handle refunds, and track bank settlements through your AI client. It connects your agent directly to Clip's financial tools to manage card payments and inventory without manual dashboard clicking. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_b63zlvKZRQcOqm0wvH1D5sEAVNqDtrQ9ofNC1hOf/ai-agent-connect - **Tags:** pos-system, card-payments, refund-management, settlements, financial-api, mexico-fintech ## Description Clip API lets you put your Mexican payment gateway on autopilot. If you're tired of logging into a merchant dashboard just to check why a payment failed or to issue a quick refund, this Connector is the solution. It gives your AI client the ability to interact with financial tools directly. You can ask your agent to generate a payment link for a customer, check your current balance, or pull a settlement report for your accountant. It handles the messy JSON and the backend heavy lifting so you can just talk to your agent like a teammate. Instead of jumping between tabs to update your product list or manage subscription plans, you can just tell your agent to sync your catalog or set up a recurring billing cycle. It makes the whole process of managing Mexican card payments much faster. By using this through the Vinkius catalog, you get a way to manage your entire payment lifecycle through a simple chat interface. It turns a multi-step administrative chore into a one-sentence command. You'll spend less time on data entry and more time actually running your business. This is especially helpful if you're dealing with high volumes of transactions where a single missed refund or an incorrect inventory count can cause major headaches. You get a reliable way to keep your records clean and your customers happy without the usual friction of manual gateway management. ## Tools ### cancel_payment_link Void an active payment link to stop a pending charge. This is useful if a customer changes their mind. ### get_settlement_reports Fetch detailed historical reports on your settlements. Use this for your end-of-month accounting. ### get_transaction_status Check the current status of a specific payment transaction. Use this to verify if a payment went through. ### list_terminals View a list of all your registered physical POS terminals. Good for managing multiple retail locations. ### refund_transaction Execute a full or partial refund for a settled transaction. This helps you resolve customer issues fast. ### list_products_catalog Pull your complete inventory catalog from Clip. This helps you see what's already live in your shop. ### add_product_to_catalog Add a new item to your Clip Point of Sale catalog. Use this to keep your inventory current. ### create_payment_link Generate a secure Clip payment link to charge a customer via card. Send this link to customers for quick billing. ### create_subscription_plan Build a recurring billing cycle for periodic client charges. This automates your monthly revenue. ### get_balance_summary Retrieve the current cash balance awaiting settlement. Check this to see your available funds. ## Prompt Examples **Prompt:** ``` Generate a new custom MXN payment link exactly for 450.50 referenced as invoice #X-99T. ``` **Response:** ``` Clip transaction mechanism engaged! I have fully generated the MXN 450.50 payment gateway link. The URL is 'https://pay.clip.mx/x99t'. It's currently active and awaiting funds capture. Shall I send it to the client via SMS logic? ``` **Prompt:** ``` Refund the latest transaction specifically identified as Txn_88Z to its origin card fully. ``` **Response:** ``` Initiating vault rollback command targeting specific Clip Txn_88Z block... Full Refund sequence finalized successfully avoiding secondary validations cleverly. The entire volume will appear on the customer's bank statement cleanly within 48 to 72 business hours. Need any more void actions handled natively? ``` **Prompt:** ``` Calculate my comprehensive real cash balance available anticipating the incoming bulk settlements today blindly. ``` **Response:** ``` Sweeping internal Clip balances... I calculate MXN 35,490.20 actively marked as 'Settled' and available for your incoming sweep to the pre-registered Banamex account within the next 14 hours automatically without intervention. You also hold 4,000 pending. Shall I print the daily CSV? ``` ## Capabilities ### Generate custom payment links Create secure links to charge customers via card instantly. ### Pull settlement reports Fetch historical data on your cash flow for accounting. ### Issue card refunds Execute full or partial refunds for settled transactions. ### Sync product inventory Keep your Clip catalog updated with your current stock. ### Create subscription plans Set up recurring billing cycles for your clients. ### Check real-time balances See exactly how much cash is awaiting settlement. ## Use Cases ### Instant Customer Refunds A customer asks for a refund on a specific order. Your agent uses `refund_transaction` to return the money to their card immediately. ### Daily Settlement Audit A manager asks for today's total sales. The agent uses `get_settlement_reports` and `get_balance_summary` to provide a clear picture of the day's cash flow. ### Rapid Inventory Sync You launch a new product. Your agent uses `add_product_to_catalog` to put the new SKU live on your Clip terminal instantly. ### On-Demand Invoicing A client needs to pay for a custom job. Your agent uses `create_payment_link` to generate a one-time MXN payment URL and sends it to the client. ## Benefits - Stop manual data entry by using `create_payment_link` to send invoices to customers instantly. - Get faster support by using `refund_transaction` to handle customer issues in seconds. - Keep your stock accurate by using `add_product_to_catalog` to sync your items as you sell them. - Save hours on accounting by using `get_settlement_reports` to pull your daily data automatically. - Automate recurring revenue with `create_subscription_plan` for your members or recurring services. - Monitor your cash flow in real-time using `get_balance_summary` to see what's coming into your bank. ## How It Works The bottom line is you get a conversational way to manage Mexican payments without opening a browser. 1. Get your merchant credentials from the Clip Developer Terminal. 2. Paste your API key into the Vinkius vault. 3. Give your agent a command to pull data or trigger a payment. ## Frequently Asked Questions **Can the Clip API MCP help me manage my Mexican business payments?** Yes, it connects your AI agent directly to the Clip payment gateway. You can generate links, check balances, and manage transactions without leaving your chat interface. **How do I use Clip API MCP to handle refunds for my customers?** You can simply tell your AI agent which transaction needs a refund. It will then communicate with Clip to process the full or partial return to the customer's card. **Can I use Clip API MCP to sync my inventory?** Absolutely. You can use it to add new products to your Clip catalog or pull your entire current inventory list into your conversation for quick reference. **Does Clip API MCP support recurring billing?** Yes, it allows you to create subscription plans. This means you can set up periodic charges for your clients automatically through the Clip infrastructure. **How does Clip API MCP help with my daily settlement reports?** It pulls detailed historical reports directly from your account. You can ask for daily summaries or specific settlement data to make your accounting much faster. **Is Clip API MCP good for high volume e-commerce in Mexico?** It is ideal for high-volume merchants who want to automate repetitive tasks like payment link generation and refund processing, reducing the risk of manual errors. **Can I automatically refund payments without ever navigating to the Clip website?** Yes. The `refund_transaction` interface executes server-side cryptographic voiding. Pass the definitive transaction ID alongside an optional amount override, and the refund logic routes directly through Clip's banking partners unconditionally. **Are the payment links generated permanent or do they have expiration windows?** By default, Payment links created via this endpoint remain actively valid until either paid successfully or explicitly halted. You can seamlessly use the `cancel_payment_link` tool to kill rogue links manually blocking external vulnerability loopholes. **Can the agent check if physical POS terminals are active and connected to my account?** Yes. The `list_terminals` endpoint fetches the fleet array directly from Clip servers. It outputs device IDs mapped to your registry ensuring no unauthorized POS physical readers are leeching payments stealthily.