# ThriveCart MCP

> ThriveCart MCP connects your AI client directly to your e-commerce sales data, letting you audit transactions and manage products without logging into a dashboard. Quickly list customers, check subscription statuses, or retrieve detailed transaction metadata—all through natural conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** checkout, payment-processing, subscription-management, transaction-auditing, sales-management, cart-platform

## Description

This MCP hands your AI agent direct access to every part of your checkout process. You stop dealing with complex dashboards and start talking sales data to your agent. Whether you sell physical goods, courses, or recurring subscriptions, your agent acts as a real-time back office expert. It can instantly list all your products for inventory checks, pull up the history for any customer, or audit specific transactions. Need to know if a coupon was applied correctly? Ask. Want to see who renewed their subscription today? Just ask. By connecting ThriveCart via Vinkius, you turn complicated sales management into simple conversation. Your agent handles all the querying and data retrieval so your revenue information is always organized and ready when you need it.

## Tools

### get_customer
Pulls all specific identifying information for a single customer account.

### get_product
Retrieves detailed specifications and pricing data for one particular product.

### get_subscription
Gathers all details related to a specific customer's recurring subscription plan.

### get_transaction
Pulls the full record and metadata for any single recorded sale or transaction.

### list_coupons
Retrieves a list of all currently active and inactive discount coupons.

### list_customers
Generates an accessible list of every customer registered in your ThriveCart account.

### list_products
Provides a comprehensive catalog listing of all products, upsells, and coupons available for sale.

### list_subscriptions
Generates an accessible list of every active and cancelled subscription record.

### list_transactions
Pulls a summarized, recent list of all sales activities that happened in your store.

### list_upsells
Lists out all the one-time upsell offers you have created for customers.

## Prompt Examples

**Prompt:** 
```
List my top 5 recent transactions in ThriveCart.
```

**Response:** 
```
I've retrieved your recent sales. You have 5 new transactions, including a $97 purchase for 'Masterclass AI' by john@doe.com. Would you like the full details for any of them?
```

**Prompt:** 
```
Show me all my active products.
```

**Response:** 
```
I've found 3 active products in your account: 'Course X', 'Ebook Y', and 'Consulting Z'. I can provide pricing and upsell info for each if you like.
```

**Prompt:** 
```
Check if there are any new subscriptions today.
```

**Response:** 
```
I've scanned your subscriptions. You have 2 new recurring agreements started today for 'VIP Program'. Both are currently in active status.
```

## Capabilities

### Audit Sales History
The agent pulls up a detailed list of recent or historical transactions, providing full metadata for every sale.

### Manage Product Catalog Details
You can retrieve the current details on all your listed products, upsells, and coupons in one go.

### Check Subscription Statuses
The MCP queries whether a subscription is active or cancelled and pulls specific customer billing records.

### View Customer Records
You can list existing customers and view their complete purchase history to calculate lifetime value.

### Retrieve Specific Sales Data
The agent fetches granular details for any single transaction, product, or customer ID you provide.

## Use Cases

### Checking for abandoned sales details
A customer support agent needs to know why a user couldn't complete their order. The agent uses list_customers and then get_transaction on the customer ID, quickly identifying if the sale failed due to an expired coupon or payment error.

### Reviewing monthly revenue dips
The e-commerce owner notices a drop in sales. They ask their agent to list_transactions for the last seven days. The tool reveals that upsells stopped running on Tuesday, pointing directly to where the problem started.

### Onboarding new staff quickly
A manager needs a quick overview of all services offered. They ask their agent to list_products and list_upsells, getting immediate confirmation that every service tier is accounted for in the catalog.

### Verifying billing discrepancies
Support team receives a complaint about an incorrect renewal charge. The agent uses get_subscription with the customer's email to pull up the exact plan details and billing cycle date, solving the issue instantly.

## Benefits

- Stop guessing on revenue. By calling list_transactions or getting_transaction details, you get a clean audit trail of sales activity, including metadata for every purchase.
- Keep your product catalog current. Use list_products to verify all products and upsells are correctly set up, eliminating the need to click through multiple admin tabs.
- Handle customer billing issues faster. With get_subscription, you can immediately check a client's status or find specific payment details without asking them for screenshots.
- Boost support speed. If a user asks about an old purchase, calling list_customers followed by get_transaction gives the agent all the necessary context in seconds.
- Maintain data integrity. The ability to call list_coupons lets your team quickly verify if discounts are applying correctly before confirming a sale.

## How It Works

The bottom line is that instead of logging into multiple dashboards to pull data, you talk to your AI client, and it pulls the exact information directly from ThriveCart for you.

1. Subscribe to this MCP and enter your ThriveCart API key.
2. Connect the MCP to your preferred AI client (like Claude or Cursor).
3. Ask your agent a natural language question, like 'What were my sales yesterday?' The tool executes the query and gives you the structured data.

## Frequently Asked Questions

**Does ThriveCart MCP track refunds?**
Yes, it tracks transaction details, which includes refund data. By calling get_transaction, you can retrieve full metadata for any specific sale and see if a refund was processed.

**Can I list all my products and their upsell options with ThriveCart MCP?**
Absolutely. You use the list_products tool to get your main catalog, and then call list_upsells to pull up every available add-on offer in one go.

**How do I check if a customer is still paying for their subscription using ThriveCart MCP?**
Use the get_subscription tool. This pulls all current payment and status details, letting you confirm if the agreement is active or when it expires.

**Is this useful for tracking coupon usage in ThriveCart?**
Yes. You can use list_coupons to see all available codes, and then audit transactions using get_transaction to verify which coupons were successfully applied on any given sale.