# Sellfy MCP

> Sellfy MCP Server gives you full control over your e-commerce store directly from your AI client. Use natural language to create products, list all customers via `list_customers`, retrieve order history with `list_orders`, or check active subscriptions using `get_subscription_details`. Manage everything without opening the dashboard.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** sellfy, ecommerce-api, digital-products, order-fulfillment, subscription-management, customer-crm, store-automation, mcp

## Description

Sellfy's **MCP Server** lets your AI client manage your entire e-commerce store without you ever having to open a dashboard. You talk naturally, and your agent executes complex backend operations across product listings, customer accounts, orders, and subscriptions. Forget clicking through tabs; this gives you full control over everything running in your shop.

### Product Catalog Management

When you need to handle inventory or listings, the `list_product_categories` tool lets you pull every category you've set up—stuff like 'Digital Downloads' or 'Physical Goods.' You can then list all items currently for sale using `list_products`, giving you a complete view of your whole catalog. Need to check out one specific item? Use `get_product_details` to get its current price, full description, and if it's available right now. If you gotta make something new on the fly, `create_product` lets you quickly list a brand-new product just by giving it a title and a price. The system also keeps track of any active discounts; run `list_store_coupons` to see every discount code you've created.

### Customer Records

You can manage your user base directly from the chat window. To get a rundown of everyone who's bought something, run `list_customers`, and it gives you a list of all accounts in your store. If you need to dig into one specific person’s profile—maybe checking an address or name—you use `get_customer_details` by providing their account info. It pulls those specific details for you.

### Tracking Sales and Orders

Monitoring revenue is where this thing shines. You can grab a summary view of your most recent sales transactions using `list_orders`. For deep-dive analysis, the `get_order_details` tool lets you pull all the metadata—the status, the exact items purchased, everything—for one specific order number. Want to know how the whole store is doing? Use `get_store_information` to get high-level summary details about your entire Sellfy setup.

### Subscriptions and Revenue Streams

For recurring money, you've got a couple of tools here. You can run `list_subscriptions` to see a summary list of all the subscription plans you offer and what their current status is. To check on one specific customer's billing, use `get_subscription_details`. This pulls the exact status, when it renews, and payment info for that single recurring service. You can keep tabs on these revenue streams without ever needing to click into a 'Billing' section.

### How It Works

Your AI client processes natural language commands against this server. When you tell it to 'list all products,' it executes `list_products`. When you say, 'what's the status of order 1234?' it runs `get_order_details('1234')`. It handles the data fetching and structure so you don't have to. This means your workflow stays right here in the chat interface; no manual dashboard navigation is required.

## Tools

### create_product
Makes a new product listing in your store, requiring just a title and price.

### get_customer_details
Pulls specific profile data for one customer using their account details.

### get_order_details
Retrieves complete metadata and status information for a single order number.

### get_product_details
Gets the current pricing, description, and availability data for one specific product.

### get_store_information
Retrieves high-level summary details about your entire Sellfy storefront setup.

### get_subscription_details
Pulls the status, renewal date, and payment information for a single recurring subscription.

### list_product_categories
Returns every product category you've set up in your store, like 'Digital Downloads' or 'Physical Goods'.

### list_store_coupons
Shows a list of every active discount coupon code you have created.

### list_customers
Generates a list of all customer accounts currently stored in your Sellfy store.

### list_orders
Grabs a summary view of the most recent sales transactions from your shop.

### list_products
Lists all products currently available for sale across the entire catalog.

### list_subscriptions
Retrieves a summary of all recurring subscription plans and their current status.

## Prompt Examples

**Prompt:** 
```
List all physical products in my Sellfy store.
```

**Response:** 
```
I've retrieved your products. You have 3 physical items including 'Custom T-Shirt' and 'Signed Poster'. Would you like to check the stock levels for any of them?
```

**Prompt:** 
```
Show me the sales analytics for all digital products this month with revenue breakdown.
```

**Response:** 
```
Monthly sales analytics. Total revenue: $12,400. Orders: 234. Products sold: 6 categories. "UI Kit Pro" leads with $4,200 (89 sales). "E-book: Design Systems" at $2,800 (140 sales, $19.99 each). "Video Course: React Mastery" at $2,100 (21 sales, $99.99). "Icon Pack Premium" at $1,800 (180 sales, $9.99). "Template Bundle" at $1,100 (22 sales). "Audio Sample Pack" at $400 (40 sales). Average order value: $53. Repeat customers: 34%. Top traffic source: Twitter (42%).
```

**Prompt:** 
```
Create a new digital product listing for a premium Figma design template at $49.99.
```

**Response:** 
```
Product created: "Premium Dashboard UI Kit - Figma". Price: $49.99. Category: Digital Download. File uploaded: dashboard_ui_kit_v2.fig (34 MB). Description: 120+ components, dark/light modes, responsive layouts. Product page generated with auto-preview thumbnails. SEO: meta title and description optimized. Payment options: credit card, PayPal. Discount code slot: empty (add anytime). Analytics tracking enabled. Shareable link generated. Estimated based on similar products: 15-20 sales/month.
```

## Capabilities

### Manage Product Catalog
List all products or create a new item definition (title and price) without touching the Sellfy dashboard.

### Review Customer Records
Pull specific details for any customer profile, or get a full list of all store users.

### Track Sales and Orders
Get summaries of recent orders and retrieve deep metadata on individual sales transactions.

### Monitor Subscriptions and Coupons
View recurring subscription details or list all active discount codes to manage revenue streams.

### Get Store Metadata
Access high-level data about the store's overall status, including product categories and general information.

## Use Cases

### The Fulfillment Check
An Ops Manager gets an alert for a pending order. Instead of opening the dashboard, they ask their agent to run `get_order_details` using the order ID. The agent returns the full fulfillment metadata, confirming shipping details and item list immediately.

### The Inventory Audit
A Digital Creator needs an inventory count for a specific physical product line. They run `list_products`, filter for 'physical goods', and use `get_product_details` on the top five items to verify pricing metadata across the board.

### The Support Inquiry
A customer calls about a billing issue. The agent asks their AI client to run `list_customers` to find the account, then uses `get_customer_details` and `get_subscription_details` to read the exact renewal date and plan level for the user.

### The Marketing Prep
A Marketing team member needs a list of all current promotions. They ask their agent to run `list_store_coupons`, which instantly returns every active discount code, allowing them to verify eligibility before running a campaign.

## Benefits

- Order tracking gets fast. Instead of diving into the dashboard to check order status, just run `list_orders` and get a summary right in your conversation window. Need details? Use `get_order_details` immediately.
- Customer service improves when you know the history. Run `list_customers`, find the profile, and use `get_customer_details` to pull payment or contact info instantly for personalized support.
- Never lose track of revenue streams again. Check your recurring income status by calling `list_subscriptions`. You can also verify active deals using `list_store_coupons` before running a promotion.
- Product management is instant. If you need to add something new, use `create_product` with just the title and price. It's faster than logging into the seller portal.
- Avoid manual data gathering. Instead of clicking through menus to see what's available, run `list_products` or check categories with `list_product_categories` to get a full inventory list in seconds.

## How It Works

The bottom line is: you talk to your AI client, not the Sellfy dashboard. It handles the API calls for you.

1. Subscribe to this server and input your Sellfy API Key into your client settings.
2. Directly ask your AI agent for a task (e.g., 'List all physical products').
3. The agent calls the relevant tool (like `list_products`), receives structured data, and reports the results back to you in plain English.

## Frequently Asked Questions

**Can my AI automatically find the details and status for a specific order by providing its ID?**
Yes! Use the `get_order` tool with the Order ID. Your agent will respond with complete metadata, including payment status, items purchased, and customer notes in seconds.

**How do I check the current subscription status for a specific customer?**
Simply ask the agent to run the `get_subscription` action with the Subscription ID. It will retrieve the detailed metadata for that recurring billing profile.

**How do I find my Sellfy API Key?**
Log in to your Sellfy dashboard, navigate to **Store Settings** > **Integrations** > **Developer API**, and you will find your unique secret API key there.

**How do I list all products in my store using the `list_products` tool?**
The `list_products` tool retrieves a catalog summary of every product. You get names and basic details for physical goods, digital downloads, and merchandise across your entire storefront.

**What information can I retrieve using the `get_store_information` tool?**
This tool provides high-level metadata about your store. You get key operational data like the primary currency, store name, and general system status without needing specific IDs.

**How do I programmatically create a new item using the `create_product` tool?**
You must provide both a title and a price when calling `create_product`. The server handles listing it immediately, making it available for customers to purchase.

**What does the `list_store_coupons` tool show me about discounts?**
It returns all active discount coupons configured in your store. You'll get the specific code, whether it’s a fixed amount or percentage off, and its expiration date.

**If I need to see who shopped on my site, how do I use `list_customers`?**
The `list_customers` tool provides an overview of every customer record in your system. It gives basic profile metadata, letting your agent verify shopper information.