# BlueSnap MCP for AI Agents MCP > BlueSnap connects your merchant account to any AI agent, letting you manage global payments and subscriptions using natural conversation. You can list transaction records, check current payout balances, monitor recurring billing plans, or retrieve detailed profiles for saved shoppers—all without logging into a dashboard. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** global-payments, recurring-billing, transaction-management, checkout, merchant-services, subscription-management ## Description Managing e-commerce finances usually means jumping between dashboards just to find one piece of data: was that payment processed? Is the subscription still active? BlueSnap changes that. Connect your merchant account via this MCP and let your AI client handle all the heavy lifting. Instead of sifting through multiple tabs, you talk to your agent and it pulls real-time information on transactions, recurring billing status, and customer profiles. It's about getting instant oversight for global payments and subscriptions directly into your workflow. Through Vinkius, you access this capability instantly from any compatible client, making payment data management part of the conversation, not a chore. ## Tools ### get_account_balance Checks your current available payout balance from BlueSnap. ### get_plan Retrieves detailed information for a specific recurring billing plan ID. ### get_subscription Fetches the current status and details of one specific subscription. ### get_transaction Gets detailed information for a single payment transaction using its ID. ### get_vaulted_shopper Pulls specific profile details for a saved customer shopper account. ### list_plans Provides an exhaustive list of all recurring billing plans available in your account. ### list_subscriptions Lists every active subscription you currently manage with BlueSnap. ### list_transactions Retrieves a list of recent payment and authorization transactions. ### list_vaulted_shoppers Generates a comprehensive list of all stored shopper profiles in your vault. ### list_vendors Lists all marketplace vendors that are managed through BlueSnap. ## Prompt Examples **Prompt:** ``` Can you show me the last five payments made by shoppers in California? ``` **Response:** ``` **Payment Activity Report** * $45.00 (ID: tx_123): Charge for subscription renewal on 2024-06-10. * $19.99 (ID: tx_456): Authorization check for vaulted shopper profile ABC789. * $1,250.40 (ID: balance): Current available payout funds are $1,250.40 USD. (Data pulled from `list_transactions` and `get_account_balance`). ``` **Prompt:** ``` What's the status of our top 3 recurring billing plans? ``` **Response:** ``` **Subscription Overview** | Plan ID | Name | Status | Next Billing Date | | :---: | :---: | :---: | :---: | | plan_001 | Basic Tier | Active | Oct 1, 2024 | | plan_002 | Pro Access | Suspended | N/A (Needs review) | | plan_003 | Enterprise | Active | Sept 28, 2024 | The 'Pro Access' plan needs manual attention. ``` **Prompt:** ``` Show me the details for shopper ID ABC789 and their payout balance. ``` **Response:** ``` **Shopper Profile: ABC789** * **Status:** Active * **Last Purchased:** $45.00 on 2024-06-10. * **Notes:** High retention value shopper. **Payout Balance Check:** Your current payout balance is **$1,250.40 USD**. No pending issues. ``` ## Capabilities ### Review Payment History Pull lists and specific details about recent charges and card authorizations. ### Manage Recurring Billing Status Query the status of all active subscriptions, view billing plans, or get specifics on a single plan. ### Audit Merchant Payouts Check your current account balance and view details for pending payouts. ### Analyze Customer Profiles List all saved shopper accounts or pull detailed data on a specific customer to understand their history. ### View Marketplace Vendors Retrieve lists of vendors managed through your BlueSnap marketplace account. ## Use Cases ### Reconciling Month-End Revenue A finance analyst asks their agent, 'What was the total revenue for subscriptions and transactions last month?' The agent calls `list_transactions` and `list_subscriptions`, providing a summarized report immediately, allowing the analyst to finalize reports without manual data export. ### Investigating Failed Payments The ops manager asks, 'Why did shopper ID 902 fail payment?' The agent uses `get_vaulted_shopper` to check saved details and then checks the specific charge using `get_transaction`, diagnosing the issue instantly. ### Auditing Marketplace Accounts A developer needs to verify which vendors are active. They prompt, 'List all managed marketplace vendors.' The agent calls `list_vendors` and returns a clean list for immediate cross-referencing with internal records. ### Checking Payout Readiness The finance team lead needs to know if funds are ready. They ask, 'What's our current payout balance?' The agent calls `get_account_balance` and reports the exact USD/EUR amount available for transfer. ## Benefits - Check real-time payout balances instantly using `get_account_balance`, eliminating the need to check a dedicated finance dashboard. - Keep track of all recurring revenue streams by calling `list_subscriptions` or checking specific details with `get_subscription`. This ensures no billing gaps are missed. - Deep dive into customer history. Use `list_vaulted_shoppers` and `get_vaulted_shopper` to analyze shopper retention data without leaving your workflow. - Streamline transaction review by calling `list_transactions`, giving you immediate access to recent payment activity for fast reconciliation. - Get a full view of available billing models using `list_plans` or check vendor status via `list_vendors`, keeping all marketplace operations visible in one place. ## How It Works The bottom line is, you get real-time payment and billing data delivered right into your conversational workflow. 1. First, subscribe to this MCP and provide your BlueSnap API Username, Password, and the correct environment (ws or sandbox). 2. Next, connect this access point to your preferred AI client—like Claude, Cursor, or any other compatible agent. 3. You can then ask natural language questions about payments, subscriptions, or shopper data directly from within that client. ## Frequently Asked Questions **How can I check my current payout balance using BlueSnap MCP?** The MCP allows you to call `get_account_balance` directly. You'll get a real-time readout of your available funds in both USD and EUR, confirming what money is ready for transfer. **Does BlueSnap MCP help me manage recurring billing plans?** Yes, you can list all active subscriptions using `list_subscriptions` or check a specific plan's details with `get_subscription`. It keeps track of your entire revenue stream. **What if I need to find out about a shopper who made a purchase months ago?** You can use the MCP to list all stored shoppers and retrieve detailed information on any specific profile using `get_vaulted_shopper`. This helps you analyze historical customer behavior. **Can I audit recent payments or transactions with this MCP?** Absolutely. You can call `list_transactions` to see a summary of your last payments, and then use `get_transaction` for the full details on any specific charge. **Is BlueSnap MCP only for U.S. payments?** No. The MCP is designed for global payment workflows. You can monitor transactions and balances across various currencies, making it useful for international e-commerce.