# MerchantSpring MCP

> MerchantSpring MCP connects your e-commerce data from multiple stores and marketplaces into one conversation. Get aggregated reports on sales, inventory levels, and product listings—no more switching tabs or logging into five different dashboards to get a full picture of your business performance.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** marketplace-analytics, sales-reporting, multi-channel-selling, e-commerce-data, performance-metrics

## Description

Managing a multi-channel store means dealing with data scattered across Amazon, eBay, and other platforms. This MCP centralizes that chaos. You connect it to any AI agent and take control of all your e-commerce intelligence through natural conversation. Instead of manually compiling reports or checking dashboards one by one, you can simply ask for total sales summaries for the quarter, or check if a specific product is low on stock across every channel. It lets you list all connected stores and get their current health status in seconds. Because Vinkius hosts this MCP, your agent accesses a unified view of your entire operation, turning scattered data points into actionable insights, letting you manage everything from order history to active alerts without ever leaving your chat window.

## Tools

### get_store_health
Retrieves the current operational status of a specific connected store account.

### get_inventory_report
Provides a detailed report on product stock levels across all linked channels.

### get_sales_summary
Calculates and returns an aggregated summary of sales figures for defined time periods.

### get_store_details
Fetches general information and metadata about a single connected store account.

### list_merchant_alerts
Pulls a list of all active notifications or warnings from the marketplaces.

### list_marketplaces
Displays a comprehensive list of every marketplace your account is connected to (e.g., Amazon, eBay).

### list_store_orders
Generates an order history listing for a chosen store and time frame.

### list_store_products
Retrieves a full list of active product listings within a specified store.

### list_store_promotions
Identifies and lists any current sales or promotional campaigns running in an individual store.

### list_stores
Lists every single connected store account that is part of your e-commerce profile.

## Prompt Examples

**Prompt:** 
```
Show me a sales summary for all my stores this month.
```

**Response:** 
```
Retrieving summary... You have total sales of $45,000 across 5 stores, with Amazon being your top performer.
```

**Prompt:** 
```
List all products for store ID 'S_98765'.
```

**Response:** 
```
Querying products... Store 'S_98765' has 150 active listings, including 'Blue Widget' and 'Red Gadget'.
```

**Prompt:** 
```
Check health status for my connected stores.
```

**Response:** 
```
Checking health... 4 stores are healthy, but your eBay AU store has a sync alert regarding inventory levels.
```

## Capabilities

### Review overall sales performance
The MCP retrieves an aggregated summary of total sales across all connected marketplaces.

### Check store operational health
It fetches the detailed status and metadata for every linked store account to ensure everything is syncing correctly.

### Manage inventory levels
You can get a full report detailing the current stock count and product listings across your multi-channel operations.

### Audit order history
The MCP lists specific orders for any single store account, allowing you to inspect past transactions in detail.

### Track marketplace activity
It pulls together all active alerts and notifications from your linked stores so nothing gets missed.

## Use Cases

### Figuring out monthly profitability
The analyst needs to know total sales across all channels. They ask the agent, 'What is the aggregated sales summary?' The agent uses `get_sales_summary` and provides a single dollar amount figure instead of forcing them to download reports from three different sites.

### Investigating a stock discrepancy
A product appears low on one site but high on another. The manager asks the agent to check inventory status, which triggers `get_inventory_report`. This immediately flags the exact SKU and stores where the mismatch is occurring.

### Handling a sudden operational failure
The store owner notices odd sales data. They ask for the system health check, using `get_store_health`. The agent reports that one of their key marketplaces has an alert, directing them exactly where to look.

### Preparing a quarterly review
The team needs to show all product listings for the board. They use the MCP to run `list_store_products` across every connected store, instantly generating a comprehensive list of every SKU they sell anywhere.

## Benefits

- Stop manually aggregating spreadsheets. Use the `get_sales_summary` tool to get total revenue across Amazon, eBay, and other channels in one query.
- Never miss an issue again. The ability to `list_merchant_alerts` instantly surfaces sync failures or payment issues from any marketplace.
- Instantly audit stock levels using `get_inventory_report`. This keeps you from selling items that are out of stock on a secondary channel.
- Quickly verify your entire setup with the `list_store_orders` and `get_store_health` tools, ensuring all accounts are active and syncing properly.
- Get a full picture of your product catalog by running `list_store_products`, which pulls listings from every connected location for comparison.

## How It Works

The bottom line is that your agent acts as the single pane of glass for all your e-commerce data, regardless of which marketplace generated it.

1. Subscribe to this MCP on Vinkius and enter your MerchantSpring API key.
2. Your agent uses the credentials to connect and pull a unified dataset of all linked store accounts and marketplaces (like Amazon or eBay).
3. You ask a question—for example, 'What were my total sales last month?'—and receive an immediate, consolidated answer.

## Frequently Asked Questions

**Does MerchantSpring MCP cover every marketplace?**
The tool supports linking multiple major marketplaces like Amazon and eBay. Use `list_marketplaces` to see exactly which platforms are supported by your account setup.

**Can I check inventory across all my stores using MerchantSpring MCP?**
Yes. You can run the `get_inventory_report` tool, and it consolidates stock data from every connected store so you know your total available units instantly.

**How do I see if any of my stores are having technical issues?**
You simply ask the agent to check health status. The `get_store_health` tool reviews metadata and sync logs, pointing out exactly which store needs attention.

**What is the difference between using list_store_orders and get_sales_summary?**
The `list_store_orders` tool gives you a detailed line-by-line record of individual transactions. The `get_sales_summary` tool aggregates that data, giving you total revenue figures for reporting.

**Can MerchantSpring MCP track promotions?**
Yes. You can use the `list_store_promotions` tool to see what sales or discounts are currently active in any specific store account.