# FastSpring MCP for AI Agents AI Agent Connect > FastSpring MCP lets you run your digital storefront from your AI client. You can track orders, manage recurring subscriptions, and update customer profiles without leaving your chat interface. It handles the heavy lifting of global payments and account management so you can focus on growing your SaaS or digital product business. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_uj3vyyx398xeG0gTA45aWMRaNVTxQljBsM7DJpdi/ai-agent-connect - **Tags:** merchant-of-record, global-tax-compliance, subscription-management, digital-commerce, order-processing, fraud-prevention ## Description Managing a global subscription business usually means jumping between tabs, hunting for order IDs, and manually updating CRM records. This Connector changes that by letting your AI agent do the digging for you. Instead of hunting through a dashboard to see why a customer's payment failed or trying to figure out which plan they're on, you just ask your agent. You can pull up specific order logs, handle plan changes on the fly, or even trigger manual renewals to save a churning customer. It makes the headless nature of FastSpring actually usable for humans. Because it's hosted on Vinkius, you get a unified way to plug this into your existing workflow, giving you a direct line to your commerce data without the friction of a traditional UI. It takes the friction out of global commerce by turning complex data arrays into simple answers. You can audit your entire product catalog to ensure your store mapping is correct or provision new account updates with a single prompt. It's about moving away from the click-heavy reality of merchant platforms and into a space where your agent handles the tedious data work. You no longer have to worry about the nuances of subscription math or the manual effort of generating secure links for users who are locked out of their portals. It's a direct path to better commerce management. ## Tools ### list_accounts Lists all bounded CRM records within the FastSpring platform. Use this to see your entire customer base in one go. ### update_account_info Sends a JSON payload to update customer profile data and hard records. Use this to sync customer changes across your platform. ### update_subscription_plan Identifies and switches a customer to a different active plan. This is the fastest way to handle plan upgrades or downgrades. ### cancel_subscription Ends a managed subscription and extracts the reason for the churn. This helps you identify why customers are leaving. ### charge_managed_subscription Triggers a manual charge based on the subscription's specific billing rules. Use this to handle ad-hoc payments or manual renewals. ### get_account_details Pulls the core properties and logic driving a specific customer account. It's useful for seeing how an account is configured. ### generate_auth_link Creates a 24-hour ephemeral JWT link for a customer to access their portal. This is a secure way to provide access without sharing passwords. ### get_order_details Retrieves cloud logs for a specific order to check limits and fraud status. Use this to audit transactions and resolve payment issues. ### get_subscription_details Inspects internal arrays to see the math behind a customer's current plan. It helps you understand proration and plan logic. ### list_catalog_products Pulls the exact structural mapping of your active store products. It's great for verifying that your packages are set up correctly. ## Prompt Examples **Prompt:** ``` What's the status of order ORD-9988? ``` **Response:** ``` ### Order Status: ORD-9988 | Detail | Status | | :--- | :--- | | **Payment Status** | Completed | | **Fraud Filter** | Passed | | **License Delivery** | Delivered | The customer successfully passed all security checks and the license keys have been issued. ``` **Prompt:** ``` Give me a login link for user account_555. ``` **Response:** ``` Auth link generated! Here is the ephemeral login URL for account **account_555**: [https://yourstore.onfastspring.com/authenticate/jwt...](https://yourstore.onfastspring.com/authenticate/jwt...) **Note:** This link will expire in 24 hours. ``` **Prompt:** ``` Why did sub_777 cancel? ``` **Response:** ``` Subscription **sub_777** has been terminated. **Churn Metadata:** - **Reason:** Price too high - **Status:** Irreversible The customer will no longer be charged for this plan. ``` ## Capabilities ### Cancel subscriptions and capture churn reasons End a managed subscription and extract the specific metadata explaining why the customer left. ### Trigger manual subscription renewals Execute manual charges for users who missed a payment cycle based on their active billing rules. ### Generate secure 24-hour login links for customers Dispatch ephemeral login tokens to give users secure access to their portals without sharing passwords. ### Update customer profile data and CRM records Send JSON payloads to update hard customer records and profile data across the platform. ### Audit order logs for fraud and payment status Retrieve cloud logs to verify if a transaction passed fraud filters and see specific order limits. ### Fetch and verify active product catalog listings Pull the exact structural mapping of your store's active products and packages. ## Use Cases ### Resolving overcharge disputes A customer claims they were overcharged. Use `get_order_details` to check the fraud filter and `get_subscription_details` to see the proration math. This allows you to give the customer a clear, data-backed explanation of their bill. ### Migrating high-value users A high-value user wants to switch plans. Use `update_subscription_plan` to move them to the correct array and `update_account_info` to sync their new status. This makes plan migrations a one-step process for your success team. ### Restoring locked-out users A user is locked out of their dashboard. Use `generate_auth_link` to send them a secure 24-hour login URL via your AI. This lets you resolve access issues in seconds without needing to touch the backend. ### Auditing store product mappings You need to do a bulk audit of your catalog. Use `list_catalog_products` to verify every active package in your store. This ensures your pricing and product mappings are accurate across your entire global storefront. ## Benefits - Stop digging through logs: Use `get_order_details` to see fraud status and order limits instantly. This saves your support team from manual log hunting and helps you resolve payment issues in seconds. - Reduce churn friction: Use `cancel_subscription` to capture specific reasons while cleaning up accounts. This gives you the metadata you need to fix the root cause of customer departures. - Speed up support: Use `generate_auth_link` to give customers secure, 24-hour access to their portals. This keeps your team from having to share passwords or handle complex reset flows manually. - Handle manual renewals: Use `charge_managed_subscription` to trigger payments for users who missed a cycle. It's the easiest way to keep revenue flowing without manual backend intervention. - Update records faster: Use `update_account_info` to sync customer data without opening the dashboard. This ensures your CRM and FastSpring records stay perfectly in sync with your latest updates. - Verify your catalog: Use `list_catalog_products` to ensure your store's digital products are mapped correctly. It helps you audit your entire offering and catch errors before they hit the customer. ## How It Works The bottom line is you get a conversational interface for your entire FastSpring commerce backend. 1. Subscribe to the FastSpring MCP on Vinkius. 2. Enter your FastSpring API Username and Password from your Dashboard. 3. Start managing your digital commerce from any MCP-compatible client. ## Frequently Asked Questions **Can I use FastSpring MCP to manage my subscriptions?** Yes, it lets you handle renewals, plan updates, and cancellations via your AI agent. You can manage the entire lifecycle of a subscription without leaving your chat interface. **How does FastSpring MCP help with customer support?** It allows your agent to fetch order details and generate secure 24-hour portal links instantly. This helps your team resolve access issues and payment inquiries much faster. **Can FastSpring MCP audit my store's products?** Yes, you can list all catalog products to verify your store's structural mapping. It's a great way to ensure your offerings are correctly configured across your global storefront. **Does FastSpring MCP handle fraud checks?** It retrieves cloud logs that show if customers successfully passed fraud filtering. This gives you visibility into order security without manual log digging. **How do I update customer info using FastSpring MCP?** You can use the Connector to provision JSON payloads that update hard customer records and CRM data. This keeps your records in sync with your latest updates automatically. **Can I use FastSpring MCP to see why customers are leaving?** Yes, it extracts rich churn reason metadata when you cancel a subscription. This provides the data you need to improve your retention strategies. **Can my agent check if an order passed fraud filtering in FastSpring?** Yes. Use the 'get_order_details' tool. The agent retrieves explicit cloud logs resolving if customers successfully passed fraud checks, providing you with the exact status of any transaction UUID. **How do I generate a customer login link via chat?** Use the 'generate_auth_link' tool. Provide the account ID. Your agent will command the FastSpring API to generate an ephemeral 24h JWT link that grants the customer secure access to their portal without a password. **Can I manually trigger a renewal charge for a subscription through the agent?** Absolutely. Use the 'charge_managed_subscription' tool. Providing the sub ID allows the agent to execute a manual renewal charge via the MoR infrastructure, handling the ad-hoc billing event synchronously.