# BlueSnap MCP for AI Agents AI Agent Connect

> BlueSnap MCP lets you manage your merchant account directly through your AI agent. You can pull transaction history, check payout balances, and monitor recurring subscriptions without switching tabs. It also lets your agent see vaulted shopper profiles and marketplace vendor lists to keep your e-commerce operations moving.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_EKLpXSptDSWs0Y85JkZG4zPlhGMC0JhmdgM19aeq/ai-agent-connect
- **Tags:** global-payments, recurring-billing, transaction-management, checkout, merchant-services, subscription-management

## Description

Managing a global payment gateway usually means jumping between browser tabs, copying transaction IDs, and squinting at dashboard tables to find out why a subscription failed or when a payout is hitting your bank. This Connector changes that by bringing your BlueSnap data directly into your conversation with your AI agent. You can ask about specific payment statuses, check your current account balance, or see which shoppers have vaulted cards for recurring billing. It handles the heavy lifting of data retrieval so you can focus on the actual business. Whether you're auditing a specific transaction or checking out your marketplace vendor list, the information comes to you in plain English. Using this via the Vinkius catalog means you can connect your merchant account once and let your agent handle the rest of the manual lookups.

## Tools

### list_vendors
List all the vendors managed within your BlueSnap marketplace. Use this to oversee your marketplace ecosystem.

### get_vaulted_shopper
Get information on a specific shopper who has saved their payment details. This helps you identify returning customers.

### list_plans
List every recurring billing plan currently in your account. Use this to see your entire catalog of subscription options.

### list_subscriptions
See a full list of all active subscriptions. This gives you a high level view of your recurring revenue.

### list_transactions
Pull a list of your most recent payment transactions. It is the fastest way to see what just happened in your store.

### list_vaulted_shoppers
See all shoppers who have vaulted cards for your merchant account. This helps you manage your most loyal customers.

### get_account_balance
Check your current payout balances across different currencies. This helps you see exactly what money is ready for your bank.

### get_plan
Get the specific details for a recurring billing plan. Use this to see the exact terms and pricing of a plan.

### get_subscription
Pull details for a specific subscription. This is useful for checking the status of a single customer's recurring payment.

### get_transaction
Retrieve detailed data for a single transaction or card authorization. It gives you a deep dive into a specific payment.

## Prompt Examples

**Prompt:** 
```
Show me my current balance and the last 3 transactions.
```

**Response:** 
```
Your current payout balance is **$2,450.12 USD**. Here are your last 3 transactions:

| Date | Amount | Status |
| --- | --- | --- |
| Oct 24 | $45.00 | Completed |
| Oct 23 | $120.50 | Completed |
| Oct 22 | $15.99 | Pending |
```

**Prompt:** 
```
Are there any active subscriptions for the 'Gold' plan?
```

**Response:** 
```
I found **142 active subscriptions** for the Gold plan. Would you like me to list the details for the most recent ones or check a specific subscription ID?
```

**Prompt:** 
```
Who are my vaulted shoppers?
```

**Response:** 
```
You have **45 vaulted shoppers**. These are customers who have saved their payment details for recurring billing. I can pull a list of these shoppers or check the details for a specific one if you provide an ID.
```

## Capabilities

### Check payout balances
See how much money is ready for withdrawal or still pending in your account.

### Retrieve transaction details
Get specific data on card authorizations and recent payments instantly.

### Monitor recurring subscriptions
View active billing plans and specific subscription statuses in one place.

### Access vaulted shopper profiles
Look up saved customer information and their payment history.

### Manage marketplace vendors
List and verify the vendors currently active in your BlueSnap marketplace.

## Use Cases

### Checking a failed payment
A customer claims they were charged but the order didn't ship. The user asks the agent to get the transaction details for that specific ID to see if the authorization actually cleared.

### Monthly payout reporting
A finance lead needs to know the balance for the week. They ask the agent to check the current account balance and list the last 20 transactions to see what's pending.

### Subscription audit
An e-commerce owner wants to see how many people are on the 'Pro' plan. They ask the agent to list all active subscriptions and then check the details for the specific plan.

### Shopper research
A support agent needs to know if a customer has a saved card. They ask the agent to find the vaulted shopper details to see if they can use a saved payment method.

## Benefits

- Stop manual dashboard searching by using list_transactions to get recent payment history instantly.
- Get real time payout updates using get_account_balance to see exactly what money is ready for your bank.
- Improve customer retention by using list_vaulted_shoppers to identify your most frequent recurring customers.
- Simplify subscription audits by using list_subscriptions to see every active plan in one view.
- Verify marketplace health by using list_vendors to see every vendor currently active in your store.

## How It Works

The bottom line is you get a conversational interface for your entire BlueSnap merchant dashboard.

1. Connect your BlueSnap account by providing your API username, password, and environment.
2. Select your preferred AI client to start interacting with your payment data.
3. Ask your agent to perform specific tasks like listing transactions or checking balances.

## Frequently Asked Questions

**Can I use BlueSnap MCP to see my merchant balances?**
Yes, it allows you to check payout balances across different currencies instantly. You can ask your agent for the current balance at any time.

**How does BlueSnap MCP help with subscription billing?**
It lets you list all active subscriptions and query specific plan details. You can quickly see your recurring revenue and subscription health.

**Can the BlueSnap MCP see my customer's full credit card numbers?**
No, it only retrieves shopper profiles and transaction metadata. Your sensitive payment data remains secure and is not exposed to the agent.

**Can I use BlueSnap MCP to manage my marketplace vendors?**
Yes, you can list and verify all vendors managed within your BlueSnap marketplace. It helps you keep an eye on your marketplace ecosystem.

**Does BlueSnap MCP work for checking transaction history?**
Yes, you can list recent payment transactions or get details for a specific transaction ID. It is a great way to audit your recent sales.

**Is the BlueSnap MCP good for e-commerce finance teams?**
It is perfect for finance teams who need to monitor payouts and subscriptions without manual dashboard navigation. It saves time on reconciliation and reporting.

**Can I check the status of a specific payment transaction?**
Yes! Use the `get_transaction` tool with the Transaction ID. Your agent will fetch the latest status, including whether it is 'Success', 'Pending', or 'Failed'.

**How do I list all my active subscription plans?**
Simply ask the agent to `list_plans`. It will retrieve all recurring billing plans configured in your BlueSnap account for you to review.

**Does the integration allow processing a new refund?**
Currently, the toolset is focused on querying and monitoring (Read-Only). You can list and inspect transactions, but processing refunds or charges must be done through the BlueSnap portal for financial security.