# Bolt MCP for AI Agents AI Agent Connect > Bolt MCP for AI Agents — Manage one-click checkouts, process refunds, and track merchant transactions directly through your AI client. It connects your Bolt Merchant account to your agent so you can handle the heavy lifting of payment lifecycle management without switching tabs. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_g8Sbl7tTFvQoAPezAPaP83Gii0J20mzEKiVlYPRy/ai-agent-connect - **Tags:** one-click-checkout, transaction-management, refund-processing, payment-gateway, conversion-optimization ## Description Imagine you're running an e-commerce store and a customer is screaming about a refund that hasn't hit their account yet. Usually, you'd have to log into your merchant dashboard, hunt for the specific transaction ID, and navigate through a series of menus to issue the credit. With this Connector, you just tell your agent to find the payment and push the refund through. It handles the actual work of talking to the API for you. You can check the status of your merchant account, audit your data sync connections to make sure everything stays updated, or generate checkout sessions to keep that one-click experience smooth for your shoppers. It’s about moving from searching for buttons to giving directions. Since Vinkius hosts this and thousands of other tools, you can keep your entire operation in one place while your agent does the manual data entry. It's for the people who want to stop being manual data movers and start being actual business owners. You get to focus on growing your brand while the technical details of payment lifecycle management happen in the background. It turns your AI client into a functional operations desk that handles the tedious parts of the job so you don't have to. For developers, it means verifying your payment flows and testing checkout generation with natural language instead of constant manual testing. ## Tools ### get_order_details Retrieve specific information about a single order. Use this to see exactly what a customer bought and when. ### capture_transaction Capture a payment that was previously authorized. This is useful for finalizing sales once you've confirmed stock. ### create_order_token Generate a secure token to start a one-click checkout. It helps keep the path to purchase as short as possible for customers. ### get_account_details Pull your current account configuration and details. Use this to quickly check your merchant identity or settings. ### get_merchant_status Check if your merchant account is active and healthy. It's a fast way to verify your connection is working correctly. ### get_transaction Fetch the metadata and status of a specific payment. This helps you troubleshoot failed payments or verify successful ones. ### list_transactions Get a list of your most recent Bolt transactions. It's the fastest way to see what's happening in your store right now. ### list_webhooks View all your configured webhooks. This helps you audit your data sync and ensure you aren't missing any updates. ### refund_transaction Issue a full or partial refund for a completed payment. Use this to quickly resolve customer complaints about returns. ### void_transaction Cancel an authorized transaction that hasn't been captured yet. This is perfect for stopping a payment before it actually clears. ## Prompt Examples **Prompt:** ``` Show me the last 5 payments we received. ``` **Response:** ``` I've retrieved your recent transactions. Notable entries include: | Date | Amount | Reference | | :--- | :--- | :--- | | Oct 24 | $45.00 | ABC-123 | | Oct 23 | $120.00 | XYZ-789 | | Oct 22 | $12.50 | DEF-456 | Would you like to see the full details for any of these? ``` **Prompt:** ``` Refund $50 from the order for Sarah Miller. ``` **Response:** ``` I've initiated a partial refund of $50.00 for the order associated with Sarah Miller. **Status:** - **Amount:** $50.00 - **Action:** Partial Refund - **Account:** Bolt Merchant The credit process has started in your account. ``` **Prompt:** ``` Is our merchant account still active? ``` **Response:** ``` Your merchant account is currently **Active**. **Configuration Details:** - **Status:** Valid - **Publishable Key:** Ends in `...xyz` - **Division ID:** `div_123` ``` ## Capabilities ### Process full or partial refunds Issue credits back to customers immediately through your agent. ### Capture authorized payments Finalize payments that were previously authorized but not yet settled. ### Void pending transactions Cancel a payment before it actually clears to prevent unnecessary charges. ### Generate checkout sessions Create secure order tokens to power one-click checkout flows. ### Audit merchant account status Check if your merchant account is active and correctly configured. ### Retrieve shopper order history Pull up specific order details and transaction metadata for customer support. ## Use Cases ### Immediate refund for a returned item A customer wants a refund. The support agent uses refund_transaction to issue the money immediately without leaving the chat. ### Verifying a successful payment An operations manager asks the agent to list_transactions to confirm that a large order went through correctly. ### Testing a new checkout flow A developer uses create_order_token to verify that the new one-click checkout flow generates valid session data. ### Checking merchant account health An admin uses get_merchant_status to ensure the account is active before launching a major marketing campaign. ## Benefits - Stop manual dashboard hopping by using list_transactions and get_order_details to see your sales in real-time. - Resolve customer complaints faster by using refund_transaction to issue credits without leaving your chat interface. - Improve conversion rates by using create_order_token to make the checkout process feel instant for your shoppers. - Keep your data synced by auditing your connections with list_webhooks and get_merchant_status. - Handle complex payment logic like void_transaction and capture_transaction using simple natural language commands. ## How It Works The bottom line is you get a voice-controlled interface for your Bolt merchant dashboard. 1. Subscribe to the Bolt MCP on Vinkius. 2. Enter your Bolt Private API Key and choose your environment. 3. Ask your agent to perform tasks like listing transactions or issuing refunds. ## Frequently Asked Questions **Can the Bolt MCP handle partial refunds?** Yes, it allows you to issue either full or partial refunds for completed transactions through your agent. **How do I use Bolt MCP to check my store's payment status?** You can simply ask your agent to check your merchant account status to see if everything is active and configured correctly. **Can I use this to see my order history?** Yes, your agent can retrieve specific details for any order, including transaction metadata and shopper history. **Does the Bolt MCP work with my existing merchant account?** Yes, it connects directly to your existing Bolt Merchant account using your private API keys. **How do I make checkouts faster?** The Connector can generate order tokens to initiate secure one-click checkout sessions, making the path to purchase much shorter. **Can I see my webhooks?** Yes, you can ask your agent to list and audit your configured webhooks to ensure your data is syncing properly. **Can I process a refund for a transaction using the agent?** Yes! Use the `refund_transaction` tool with the Bolt reference ID and the amount in cents. Your agent will initiate the credit transaction in your Bolt account. **How do I check the status of a specific Bolt transaction?** Simply ask the agent to `get_transaction` and provide the reference ID. It will retrieve the latest status, such as 'Authorized', 'Completed', or 'Failed', directly from Bolt. **Can I use this to generate a checkout session token?** Yes. Use the `create_order_token` tool and provide the cart details in JSON format. This will return a token that can be used on your frontend to open the Bolt checkout modal.