# FastSpring MCP

> FastSpring lets your agent take full control of global digital commerce, payments, and subscriptions. Track orders, manage billing rules, check account details, and handle entire subscription lifecycles—all through natural conversation. It gives you direct access to complex payment data usually locked in a dashboard, letting your AI client perform deep audits or trigger changes without manual navigation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** merchant-of-record, global-tax-compliance, subscription-management, digital-commerce, order-processing, fraud-prevention

## Description

Need to audit a customer's transaction history or manage recurring billing? This MCP connects your agent directly into the FastSpring platform, giving it full control over global payments and subscription management. Instead of logging into multiple dashboards and manually searching through logs, you can talk to your AI client and get answers immediately. You can check specific order details, verify if a customer successfully passed fraud checks, or even handle complex plan updates for existing subscriptions.

It’s built for deep operational work. You can use it to identify and update core customer records, ensuring that profile data stays current across your system. Need to cancel a subscription? The agent handles the process securely while pulling out rich notes about why the customer left—that's valuable churn metadata. This level of payment orchestration is usually hidden away deep in a platform backend; Vinkius makes it available via natural language commands, turning complex commerce operations into simple conversations.

## Tools

### cancel_subscription
Terminates a managed subscription and returns detailed notes about the reason for cancellation.

### charge_managed_subscription
Applies structured billing rules to calculate and export active charges for a managed plan.

### get_account_details
Extracts core properties needed to check or update an existing customer account record.

### generate_auth_link
Creates a temporary, limited-time login link for a user to access their private portal.

### get_order_details
Retrieves comprehensive cloud logs detailing an order's status and confirming if fraud filtering was successful.

### get_subscription_details
Inspects deep internal data arrays to understand how specific billing plans are calculated or measured.

### list_accounts
Identifies and lists all existing customer records housed within the FastSpring platform.

### list_catalog_products
Retrieves a complete list of configured products, verifying their mapping status in your store.

### update_account_info
Processes and saves updated customer profile information by generating a new JSON payload.

### update_subscription_plan
Changes an active subscription to reflect a different plan type, maintaining accurate billing records.

## Prompt Examples

**Prompt:** 
```
What is the status of FastSpring order 'ORD-12345'?
```

**Response:** 
```
Retrieving order details... Order ORD-12345 is currently 'Completed'. The customer successfully passed fraud filtering and the license keys have been delivered. Would you like the buyer's email address?
```

**Prompt:** 
```
Generate a 24h auth link for account 'acc_abc123'
```

**Response:** 
```
Auth link generated! Here is the ephemeral login URL for account acc_abc123: https://yourstore.onfastspring.com/authenticate/jwt... This link will expire in 24 hours.
```

**Prompt:** 
```
Cancel subscription 'sub_xyz789' and tell me why
```

**Response:** 
```
Subscription cancelled! sub_xyz789 has been terminated. The recorded churn metadata indicates the reason was 'Price too high'. The customer will no longer be charged for this plan.
```

## Capabilities

### Audit Order History
The agent retrieves detailed cloud logs to trace order limits and confirm if fraud filters passed for specific transactions.

### Manage Subscriptions
You can check renewal dates, apply currency rules, or trigger ad-hoc billing charges on managed plans.

### Update Customer Accounts
The agent finds and updates customer records within the system using profile data like email addresses.

### Cancel Subscriptions
It securely terminates subscriptions, extracting valuable notes about why the customer is leaving (churn reasons).

### Verify Product Catalog
The agent retrieves a list of configured packages and confirms which digital products are currently active in your store.

## Use Cases

### Troubleshooting a Failed Order
A user needs to know why order 'ORD-90210' failed. Instead of checking five different internal dashboards, they ask their agent to use `get_order_details`. The agent immediately confirms the exact failure point and if fraud filtering was the issue.

### Mid-Cycle Plan Upgrade
A client calls wanting to upgrade their plan. The operations team asks their agent to first check current details using `get_subscription_details` and then apply the change safely with `update_subscription_plan`, all in one conversation.

### Reconciling Old Revenue
The finance team needs to manually trigger renewals for a specific cohort of users. They command their agent to run bulk iterations, executing the revenue recovery process by calling tools like `charge_managed_subscription`.

### Mass Account Cleanup
A manager discovers several outdated user accounts. Using `list_accounts`, they find all stale records and then use `update_account_info` to mass-clean the profile data, keeping the system accurate.

## Benefits

- Audit complete order history using `get_order_details`. You don't just see the status; you get cloud logs confirming if fraud filters passed, which is critical for compliance checks.
- Handle customer accounts with precision. Use `list_accounts` to find all user records and `update_account_info` when a client changes their email or name.
- Stop guesswork on billing cycles. The agent uses `get_subscription_details` to inspect internal arrays, letting you verify complex plan math for proration or renewals.
- Keep your customers happy with quick access. Running `generate_auth_link` gives Customer Success the ability to instantly issue secure login URLs without manual workarounds.
- Manage churn systematically. Instead of just cancelling an account, use `cancel_subscription` which pulls rich metadata detailing *why* the customer is leaving.

## How It Works

The bottom line is, you use your AI client to talk directly to FastSpring’s operational backend without ever touching a dashboard.

1. Subscribe to this MCP and provide your FastSpring API Username and Password, found in the Dashboard under Integrations.
2. Connect your AI client. Your agent now has access to all commerce tools via natural language prompts.
3. Ask a question or give a command—like 'Check order ORD-12345'—and the MCP executes the necessary API calls.

## Frequently Asked Questions

**How do I check an order status using FastSpring MCP?**
You use the `get_order_details` tool. This retrieves explicit cloud logs that show not only the order status but also if the customer successfully passed fraud filtering.

**Can I change a subscription plan with FastSpring MCP?**
Yes, you use the `update_subscription_plan` tool. This lets your agent identify precise active arrays and update the user's billing structure accurately.

**What is needed to access FastSpring MCP?**
You must subscribe to this MCP on Vinkius and provide your FastSpring API Username and Password from your dashboard credentials area.

**Does FastSpring MCP handle customer data updates?**
Yes. You can use `update_account_info` to provision a new JSON Payload, allowing you to update core customer details like email addresses across the platform.

**How do I generate an authentication link using FastSpring MCP?**
Use the `generate_auth_link` tool. It runs an automated validation check and instantly creates a secure, time-limited login URL for your customer service team to use.