# Clip API MCP > The Clip API MCP connects your AI client directly to Mexico's leading payment gateway, automating complex financial operations. You can generate secure payment links for instant collections, execute full or partial refunds on past transactions, and pull detailed settlement reports without touching a dashboard. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** pos-system, card-payments, refund-management, settlements, financial-api, mexico-fintech ## Description This MCP lets you manage all point-of-sale tasks in Mexico through plain conversation. Instead of navigating clunky merchant dashboards, your AI client handles the heavy lifting. You can programmatically create secure payment links mapped to specific customer needs. Need to correct an error? The system executes full or partial refunds on settled transactions instantly. It also pulls bulk settlement reports, giving you clean matrices detailing when funds hit your bank accounts. This capability means your agent can keep track of pending authorizations and reconcile inventory by syncing SKUs directly with the payment catalog. With Vinkius hosting this MCP, your AI client gains access to a specialized set of financial tools, making complex payment flows manageable through simple commands. ## Tools ### add_product_to_catalog Adds a new item listing directly into the Clip point-of-sale product catalog. ### cancel_payment_link Voids an active payment link, preventing any future charges associated with it. ### create_payment_link Generates a secure payment link for collecting money from customers using their card. ### create_subscription_plan Builds and initiates a recurring billing cycle to charge clients at set intervals. ### get_balance_summary Retrieves the total cash balance that is currently waiting for settlement. ### get_settlement_reports Fetches detailed reports covering all historical financial settlements and deposits. ### get_transaction_status Checks the specific status of a payment transaction to confirm its current state. ### list_products_catalog Pulls a complete list of every product SKU registered in your Clip catalog. ### list_terminals Lists all physical Point-of-Sale terminals linked to your merchant account. ### refund_transaction Executes a full or partial refund for any transaction that has already settled. ## 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 Payment Links Creates unique, secure links that allow customers to pay via card immediately. ### Process Refunds Issues full or partial refunds for any settled transaction identifier. ### Track Transactions Checks the current status of a payment to confirm if it was authorized, pending, or failed. ### Pull Settlement Reports Retrieves comprehensive historical data showing all funds deposited into your registered bank accounts. ### Manage Product Inventory Adds new items to the point-of-sale catalog or updates existing product details. ### Handle Recurring Billing Sets up subscription plans and charges clients periodically using Mexican cards. ## Use Cases ### A customer claims they were double-charged for an old order. The support agent uses `get_transaction_status` to find the original charge date and then executes the `refund_transaction` tool, ensuring the correct amount is returned immediately. The entire process happens in chat. ### The e-commerce site launched a new product line. Instead of manually uploading spreadsheets, the architect uses `add_product_to_catalog` to instantly make the new SKUs available for sale through Mexico's payment gateway. ### The finance team needs to reconcile last week’s physical sales against bank deposits. They use `get_settlement_reports` to pull all historical settlement data and then compare that clean matrix directly against their internal ledger, catching discrepancies in minutes. ### The company needs to start charging clients monthly for a premium service. The manager uses `create_subscription_plan`, defining the billing cycle and amount. The system handles future recurring payments using Mexican cards automatically. ## Benefits - Stop manually tracking money movement. You can use the `get_settlement_reports` tool to pull clean matrices charting exactly when cash hits your registered banks, giving you real-time visibility into funds. - Customer support gets faster. Instead of looking up old transaction numbers, running `refund_transaction` allows your agent to process full or partial refunds instantly for any settled payment. - Catalog management is simple. You can use `add_product_to_catalog` and `list_products_catalog` to keep your product listings in Clip perfectly synced with your main inventory system. - Subscription billing becomes automated. Use `create_subscription_plan` to set up recurring charges, eliminating the need for manual invoicing every month. - Collection demands are faster than email chains. The `create_payment_link` tool instantly spins up secure payment URLs mapped directly to specific customer workflows without any manual clicks. - Audit trails are clear. You can check transaction status using `get_transaction_status` to confirm exactly where a payment is in the process, solving 'Where's my money?' questions immediately. ## How It Works The bottom line is that you talk to your agent like talking to a coworker; it handles the API calls behind the scenes. 1. First, you must secure your merchant approval credentials from the Clip developer portal. 2. Next, copy your API Key and paste it into the vault perimeter provided by Vinkius to lock down the environment. 3. Finally, simply issue a command. Your AI client interprets the request and executes complex financial payloads as simple conversation. ## Frequently Asked Questions **How do I use Clip API MCP to find out how much cash is ready for withdrawal?** Use the `get_balance_summary` tool. This function retrieves your total current balance that has been marked as 'Settled' and waiting to be transferred to your bank. **Can I use Clip API MCP to manage my online store inventory?** Yes, you can sync SKUs using `add_product_to_catalog` or `list_products_catalog`. This keeps your e-commerce catalog perfectly matched with what the payment gateway tracks. **What if I need to correct a charge from last month?** Use the `refund_transaction` tool. You provide the transaction ID, and the MCP executes either a full or partial refund immediately against that settled record. **Is Clip API MCP only for Mexico transactions?** Yes, this MCP is specifically designed to interact with payment gateway functions operating within Mexico, handling local financial processes. **How do I set up monthly payments using the MCP?** You use `create_subscription_plan`. You define the charge amount and frequency, and the system handles the recurring billing cycles on your behalf.