# Bolt MCP for AI Agents MCP

> Bolt lets your AI agent manage everything from one-click checkout to complex refunds. Track every transaction, generate order tokens for secure payments, and check merchant account health—all through natural conversation directly in your workflow.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** one-click-checkout, transaction-management, refund-processing, payment-gateway, conversion-optimization

## Description

Managing e-commerce payments usually means jumping between dashboards: checking status codes, manually looking up customer history, or initiating a refund via a separate form. This MCP changes that. You connect Bolt to any AI client, giving your agent direct access to the full payment lifecycle. Your agent can instantly list recent transactions and pull detailed metadata for any specific charge. Need to fix an order? Your agent handles it—it can capture an authorized transaction or void one if something went wrong before checkout completes. Beyond payments, you can generate secure order tokens to kick off a new purchase session, all without ever leaving your chat interface. It’s payment management built into conversation. When you connect Bolt through the Vinkius Catalog, your agent becomes a full-time operations specialist.

## Tools

### capture_transaction
Finalizes a pending payment by capturing the funds from an already authorized transaction.

### create_order_token
Generates a unique, secure token required to start a one-click checkout session for a customer.

### get_account_details
Retrieves the general and current configuration details of your merchant account.

### get_merchant_status
Checks the real-time operational status, ensuring your merchant account is active and configured correctly.

### get_order_details
Fetches comprehensive details for a specific order associated with a customer or reference number.

### get_transaction
Retrieves all available metadata and specifics for one particular transaction ID.

### list_transactions
Pulls a list of your most recent payment transactions, giving an overview of activity.

### list_webhooks
Audits and lists all currently configured webhooks to ensure real-time data sync is working correctly.

### refund_transaction
Initiates a refund, which can be full or partial, for any completed transaction ID.

### void_transaction
Reverses an authorized payment that failed to complete and needs to be cancelled before capture.

## Prompt Examples

**Prompt:** 
```
List my last 5 transactions and tell me if any are authorizations that need voiding.
```

**Response:** 
```
**Recent Transaction Summary**

| Ref ID | Type | Amount | Status |
|---|---|---|---|
| ABC-123 | Charge | $45.00 | Completed |
| XYZ-789 | Auth | $120.00 | Pending $|
| QRS-444 | Charge | $22.50 | Completed |

The authorization (XYZ-789) is still pending and ready to be voided if the order was cancelled.
```

**Prompt:** 
```
I need a partial refund of $10 for transaction ABC-123.
```

**Response:** 
```
*Refund initiated.* 

We've successfully started a partial credit of **$10.00** (1000 cents) for the original payment reference ABC-123. The funds should appear in your account within 3-5 business days.
```

**Prompt:** 
```
What is the current status of my merchant account?
```

**Response:** 
```
**Merchant Account Status Report**

* **Status:** Active and Operational 
* **Publishable Key Endings:** ...xyz 
* **Division ID:** div_123 
* **Last Checked:** 2026-06-12. All configurations are valid for immediate payment processing.
```

## Capabilities

### List Recent Transactions
The agent pulls a list of your most recent payment transactions, giving an overview of activity.

### Get Specific Transaction Details
The agent retrieves all available metadata and specifics for one particular transaction ID.

### Process Refunds
Your agent can issue partial or full refunds for completed sales, or void authorizations that never went through to capture.

### Create Order Tokens
The MCP creates secure order tokens, allowing your agent to initiate a one-click checkout session when needed.

### Check Merchant Status
Get real-time data on your merchant account's current operational status and configurations.

## Use Cases

### A customer claims they were double-charged.
The agent uses `list_transactions` to show the customer all recent charges. They then use `get_transaction` on the relevant entry, confirming a duplicate payment and automatically initiating a refund via `refund_transaction`.

### An employee needs to check if an order was cancelled.
The agent fetches the specific order details using `get_order_details`. If the transaction is pending, they can use `void_transaction`, confirming the cancellation without needing internal API access.

### A developer needs to test a payment flow.
The agent uses `create_order_token` to simulate a new purchase session. They then call `get_merchant_status` to verify that the sandbox environment is correctly configured for testing.

### A team needs to audit webhooks.
The agent calls `list_webhooks`, providing an instant, auditable list of every real-time data sync endpoint connected to the merchant account.

## Benefits

- Stop switching between payment dashboards. Your agent handles transaction oversight, letting you list recent payments or pull deep metadata on a single charge without leaving your chat.
- Streamline customer support resolution. Instead of copying reference numbers, the agent gets order details and transaction histories directly from their workflow tools.
- Secure checkout is simple. Use the `create_order_token` tool to generate payment tokens instantly, making one-click checkouts easy for customers and your team.
- Control payments end-to-end. If a sale fails or needs adjustment, you can use `void_transaction` on an authorization or execute a refund with `refund_transaction`—all in conversation.
- Stay compliant and operational. You can quickly check the merchant account's status using `get_merchant_status`, verifying everything is running right before a big sale.

## How It Works

The bottom line is that your AI client talks directly to Bolt, acting like a natural language wrapper around complex financial APIs.

1. Subscribe to this MCP and provide your Bolt Private API Key along with the environment (sandbox or live).
2. Your AI client connects, giving it permission to execute payment-related actions against your account.
3. You simply tell your agent what you need—for example, 'Refund $15.00 for transaction ABC-123'—and it executes the required task.

## Frequently Asked Questions

**How can I use the Bolt MCP to process a refund?**
You simply ask your agent to issue a refund and provide the transaction reference or order ID. The agent handles checking if the payment is complete, verifying the details, and executing the refund through the necessary tools.

**Can I use this MCP for payments from different countries?**
Yes, as long as your Bolt Merchant account supports those currencies and transaction types. The MCP functions on whatever payment flows are configured within your connected merchant account.

**What if my order fails before checkout? Can I cancel the authorization?**
Absolutely. You can use the MCP to void pending authorizations using tools like `void_transaction`. This reverses the temporary hold on funds, preventing issues later in your accounting cycle.

**Is the Bolt MCP only for viewing data?**
No. It's a full management tool. You can actively perform actions like creating order tokens, capturing authorized payments, and issuing refunds right from your chat interface.

**Do I need to manually update my API keys in the MCP?**
Once you connect it via Vinkius, you enter your private API key once. The connection persists so your agent can access payment data and execute commands whenever needed.