# Bold MCP for AI Agents AI Agent Connect

> Bold MCP lets you manage your Colombian payment infrastructure through your AI client. It handles terminal management, online card payments, and transaction tracking. You can create payment links, process refunds, and monitor your merchant balance without leaving your workspace. It's built for e-commerce and retail businesses in Colombia.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_3MG6t46IAdjFtUTluLyc1V59U3aPfFpMJ6OruX7C/ai-agent-connect
- **Tags:** pos-terminals, online-payments, merchant-services, payment-links, transaction-settlement, smb-tools

## Description

Managing payments in Colombia often feels like a chore. You have to log into a dashboard, find the right button to create a link, copy the URL, and then paste it into a chat. If a terminal goes offline, you're hunting through a list of serial numbers just to see which one is dead. This Connector changes that by letting your AI client handle the heavy lifting. You can just tell your agent to check your balance or see if a specific datáfono is active. It handles the technical details of processing card-not-present payments and managing your webhooks so you don't have to. Whether you need to issue a refund for a returned item or generate a new payment link for a specific invoice, it's all just a conversation away. By connecting Bold to the Vinkius catalog, you turn your AI into a dedicated operations assistant. It cuts out the friction of manual data entry and gives you a single place to manage your entire payment flow.

## Tools

### get_online_payment
View the specific details and status of a past online card transaction.

### get_payment_link
Retrieve the details of a specific payment link you created earlier.

### list_payment_methods
See a list of all the different payment methods you currently accept.

### list_terminals
See all your bound datáfonos and check if they are currently online or offline.

### list_transactions
Get a list of your most recent payment transactions for quick review.

### list_webhooks
See all the webhooks you have currently configured in your account.

### refund_payment
Send a full reversal back to the original payment method for an approved transaction.

### create_online_payment
Process a card payment for a customer using tokenized details and required anti-fraud info.

### create_payment_link
Generate a unique URL for a customer to pay a specific amount in Colombian Pesos.

### create_webhook
Register a new URL to receive real-time notifications about your transaction events.

### delete_webhook
Remove an existing webhook endpoint from your merchant account.

### get_account_balance
Check the current funds and pending disbursements in your Bold merchant account.

### get_transaction
Look up the details of a single transaction to see card brands and settlement info.

### initiate_terminal_payment
Trigger a payment flow on a physical datáfono using its serial number.

## Prompt Examples

**Prompt:** 
```
Which of my terminals are currently offline?
```

**Response:** 
```
I checked your Bold account and found 1 offline terminal: **Smart Pro #BLD-1156**. All other 2 terminals are currently online and ready for payments.
```

**Prompt:** 
```
Create a payment link for 200,000 COP for invoice 55.
```

**Response:** 
```
I've created that for you. You can send this link to your customer: **https://checkout.bold.co/pay/xyz789**. It's set for 200,000 COP and will expire in 24 hours.
```

**Prompt:** 
```
What was my balance at the end of yesterday?
```

**Response:** 
```
I looked at your recent history. Your current merchant balance is **4,500,000 COP**, with 150,000 COP currently pending disbursement.
```

## Capabilities

### Create shareable payment links
Generate a unique URL for a customer to pay a specific amount in Colombian Pesos.

### Process online card payments
Execute card-not-present transactions using tokenized details and anti-fraud info.

### Manage physical datáfono terminals
Check the status of your bound terminals and trigger in-store payment flows remotely.

### Issue full payment reversals
Send a full refund back to the original payment method for an approved transaction.

### Monitor merchant account balances
Check your current available funds and pending disbursements instantly.

### Track real-time transaction history
Query your recent sales and individual payment details for quick review.

### Register and manage webhooks
Set up and manage HTTPS endpoints for real-time transaction event notifications.

## Use Cases

### Sending a quick payment link
A customer wants to pay an invoice but doesn't have a card. Ask the agent to use create_payment_link for the specific amount to get a URL instantly.

### Checking terminal connectivity
A retail manager needs to know if a shop terminal is working. Use list_terminals to check the connectivity of every datáfono at once.

### Handling a product return
A customer wants a refund for a faulty product. Use refund_payment to send the money back to their original card without manual entry.

### Verifying a specific sale
A finance person needs to know if a payment cleared. Use get_transaction to see the card brand and settlement data for a specific order.

## Benefits

- Stop switching tabs between your dashboard and your chat app by managing Bold payments directly in your agent.
- Speed up sales by using create_payment_link to send customers a way to pay instantly via WhatsApp or email.
- Keep your hardware updated by using list_terminals to see which datáfonos are online without checking them manually.
- Simplify your accounting by using list_transactions to pull history for your weekly reconciliation reports.
- Reduce customer friction by using refund_payment to handle reversals quickly without logging into a portal.
- Automate your notifications by using create_webhook to send real-time updates to your own systems.

## How It Works

The bottom line is you get a voice-controlled interface for your entire Colombian payment stack.

1. Subscribe to the Bold MCP on Vinkius.
2. Enter your Bold API Key and Secret Key in your AI client settings.
3. Start asking your agent to manage payments or check terminal statuses.

## Frequently Asked Questions

**Can I use Bold MCP to manage my datáfonos?**
Yes, you can use it to see which terminals are online and trigger payments remotely.

**How do I create payment links with Bold MCP?**
Just ask your agent to generate a link for a specific amount and it will provide the URL.

**Can I process refunds through the Bold MCP?**
Yes, it can issue full reversals to the original payment method for you.

**Does Bold MCP work for Colombian Pesos?**
Yes, it is specifically designed for the Colombian payment infrastructure.

**How does Bold MCP help with reconciliation?**
It lets you query transaction history and balances directly through your AI client.

**Can I set up webhooks with Bold MCP?**
Yes, you can register and manage HTTPS endpoints for real-time transaction alerts.

**Can my AI remotely trigger a payment on one of my physical Bold terminals?**
Yes! Use the `initiate_terminal_payment` tool with the terminal serial number and amount in COP. The datáfono will immediately display the checkout screen for the customer to tap or insert their card.

**How do I generate a payment link that I can share with my customers via WhatsApp or email?**
Simply ask the agent to run `create_payment_link` with the amount in COP and a description. You'll receive a unique URL that your customers can open to complete the payment securely through Bold's hosted checkout.

**Can I check my settlement balance and pending disbursements through my AI agent?**
Absolutely. The `get_account_balance` tool returns your real-time available balance and pending settlement amounts in COP, giving you instant financial visibility without logging into the Bold dashboard.