# Bold Payments MCP for AI Agents MCP > Bold lets you manage every facet of your Colombian payment system directly through your AI agent. Process online card payments, generate shareable links for invoices, remotely operate physical POS terminals, and track settlements—all from a natural conversation with no dashboard switching. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** pos-terminals, online-payments, merchant-services, payment-links, transaction-settlement, smb-tools ## Description Connect Bold to your workflow via any MCP-compatible client and gain full control over your entire Colombian payment infrastructure using plain talk. You can manage everything from generating secure payment links for e-commerce sales to listing all connected physical terminals and triggering payments remotely at the point of sale. Need to fix a mistake? You'll process refunds back to the original card method right through your agent. The system handles transaction intelligence, letting you query historical records by date range or inspect individual details like the card brand used. If you’re managing multiple payment systems, Vinkius makes sure this connection is easy to set up and use. This MCP turns your AI client into a dedicated payments operations assistant, eliminating context switching between your day-to-day work and the Bold dashboard. ## Tools ### create_online_payment Processes a card-not-present payment online, requiring specific tokenization details and the amount in COP. ### create_payment_link Generates a unique, shareable link for customers to pay a specified amount in Colombian Pesos (COP). ### create_webhook Registers a new HTTPS endpoint so Bold can send real-time notifications about transaction events. ### delete_webhook Removes an existing webhook endpoint from your merchant account configuration. ### get_account_balance Checks and returns the current available balance of your Bold merchant account. ### get_online_payment Retrieves detailed information about a specific online payment transaction. ### get_payment_link Fetches the current status and details for a known payment link. ### get_transaction Gets all specific details related to a single transaction ID or reference number. ### initiate_terminal_payment Triggers a payment directly on a physical POS terminal, requiring the serial number and COP amount. ### list_payment_methods Lists all accepted card types and payment methods supported by your account. ### list_terminals Retrieves a list of all physical datáfono devices currently linked to your merchant account, including their status. ### list_transactions Lists a summary of recent payment transactions over a specified time period. ### list_webhooks Shows all webhook endpoints you have currently configured and active on your account. ### refund_payment Issues a full reversal for an approved payment, sending the funds back to the original cardholder method. ## Prompt Examples **Prompt:** ``` Show me all the terminals connected to my account. I need their serial numbers. ``` **Response:** ``` **Active Terminals Report** * Smart Pro #BLD-4291: Online, Last transaction 2 minutes ago. * Smart Mini #BLD-7803: Online, Idle (Ready for use). * Smart Pro #BLD-1156: Offline. Status requires physical check. Please note that you can also tell me to send a payment request to any of these units. ``` **Prompt:** ``` I need a payment link for 325,000 COP for Invoice #INV-987. It expires in 48 hours. ``` **Response:** ``` Link generated successfully! Here is your shareable URL: `https://checkout.bold.co/pay/xyz123abc`. The link details are: * **Amount:** 325,000 COP * **Reference:** INV-987 * **Expires:** [Date + 48 hours] You can send this via email or text message. Let me know if you need another one. ``` **Prompt:** ``` What were my total sales from the last two weeks, and how many payments did I process? ``` **Response:** ``` **Sales Summary (May 15 - May 29)** * **Total Processed Volume:** $18,700,000 COP * **Transaction Count:** 245 transactions * **Success Rate:** 96.8% (237 approved) * **Refunds Issued:** $1,500,000 COP in refunds. The peak day was May 22nd with 45 sales. Do you want me to break this down by payment method? ``` ## Capabilities ### List all connected datáfono devices and remotely trigger in-store payment flows. Manages physical POS terminals. ### Handle card-not-present transactions by processing payments or creating shareable links for specific amounts. Manages online e-commerce payments. ### Query past payment transactions using date ranges and retrieve detailed information on individual settlements, including card brand data. Provides transaction intelligence and audit trails. ### Issue full refunds for approved online payments back to the original payment method. Manages financial reversals. ### Check your current merchant account balance, including available funds and any pending disbursements. Provides real-time financial oversight. ## Use Cases ### Physical store terminal troubleshooting A retail manager notices a POS machine is offline. They ask their agent to `list_terminals`. The agent identifies the specific serial number and confirms its connectivity status, allowing the manager to fix it immediately without calling tech support. ### Handling invoice payments for e-commerce An operator needs payment from a client. Instead of emailing a manual link, they ask their agent to `create_payment_link` for the exact invoice amount, getting a ready-to-share, expiring URL. ### Monthly financial reconciliation A finance team member asks their agent to `list_transactions` for the last quarter. The agent aggregates all data, reports total volume processed, and identifies any discrepancies that need investigation or refunding. ## Benefits - Process payments instantly: Use `create_online_payment` or `initiate_terminal_payment` to handle card transactions whether they're online or at a physical store. - Simplify reporting: Get full visibility into cash flow by using `list_transactions` and `get_transaction` to audit payment history across date ranges. - Automate link distribution: Generate secure, time-sensitive payment links with `create_payment_link`, letting you collect funds without sending invoices manually. - Control your physical network: Use `list_terminals` to see every POS device connected and remotely test or trigger payments using `initiate_terminal_payment`. - Handle reversals easily: Issue full refunds by calling `refund_payment`, which automatically sends the reversal back to the original payment source, saving reconciliation time. ## How It Works The bottom line is that you manage payments and terminal operations entirely through conversation with your AI client. 1. Subscribe to this MCP and provide your Bold API Key and Secret Key. 2. Connect the credentials to your preferred AI client (Claude, Cursor, etc.). 3. Ask your agent natural language questions like, 'Show me all terminals' or 'Process a payment for 500,000 COP,' and it executes the command. ## Frequently Asked Questions **How can the Bold Payments MCP help me manage my POS terminals?** You can list all connected datáfono devices and check their real-time status. If a machine is acting up, you can even tell your agent to trigger a test payment right on that terminal using `initiate_terminal_payment`. **Does the Bold Payments MCP make generating invoices easier?** Yes. You don't have to email manual links. Your agent can generate a secure, shareable payment link with the exact amount and reference number you specify, perfect for e-commerce. **I need to check my total sales history using the Bold Payments MCP.** The MCP lets you query transaction logs over specific date ranges. You get a summary of total volume processed, how many transactions passed, and details on any refunds that occurred during that time. **How do I handle customer refunds with this MCP?** You simply ask your agent to issue the refund. It processes the full reversal back to the original payment method using `refund_payment`, keeping a record of the action for accounting. **Can I monitor my merchant account balance with Bold Payments MCP?** Absolutely. You can ask your agent to check your current account balance anytime, getting details on available funds versus any pending disbursements so you always know your cash position.