# Marketplacer MCP

> Marketplacer MCP connects your AI client directly to a complex enterprise marketplace platform. Audit every part of your e-commerce business—from product listings and vendor accounts to detailed order invoices and live shipment tracking—using natural conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** marketplace-management, dropshipping, product-catalog, seller-network, enterprise-commerce

## Description

Managing a large, multi-vendor marketplace means jumping through endless dashboards just to get a full picture of operations. This MCP lets you do that audit work using only plain language with your AI agent. Instead of manually running reports on seller lists or sifting through webhook logs, you talk to this connector and it handles the data retrieval. You can ask your agent to list every active vendor, pull up recent invoices with line item breakdowns, or even trace a shipment's entire fulfillment history. When you connect Marketplacer via Vinkius, your agent gains immediate access to all these deep systems—the product catalog, order audit trails, and logistics data—without needing any boilerplate code. It’s about turning complicated backend operations into simple conversations.

## Tools

### list_adverts
Lists all available product items (adverts) in the marketplace catalog.

### get_advert
Retrieves detailed information about a specific product advert using its node ID.

### list_invoices
Fetches a list of all registered orders on the platform for audit purposes.

### get_invoice
Gets the full details and line items for one specific invoice using its node ID.

### list_sellers
Retrieves comprehensive lists of active third-party vendors on the platform.

### list_categories
Explores the marketplace's internal category structure and product hierarchies.

### list_webhooks
Audits which event subscriptions are configured for automated integrations.

### list_shipments
Generates a list of all tracked shipment records to monitor logistics.

### graphql_query
Allows you to run sophisticated, custom GraphQL queries against any data point in the marketplace schema.

## Prompt Examples

**Prompt:** 
```
List the last 5 invoices in my Marketplacer instance
```

**Response:** 
```
I've retrieved the latest 5 invoices. Highlights include Invoice #INV-123 ($150.00 from Seller A) and Invoice #INV-456 ($85.50 from Seller B). Would you like to see the shipment status for any of these?
```

**Prompt:** 
```
Search for sellers containing 'Outdoor' in the network
```

**Response:** 
```
Searching seller network… I've identified 3 vendors: 'Outdoor Adventure Gear' (ID: sel-123), 'Premium Outdoor Living' (ID: sel-456), and 'The Great Outdoors' (ID: sel-789). I can fetch the advert count for each seller if you'd like.
```

**Prompt:** 
```
Run a GraphQL query to fetch the 'legacyId' and 'title' for advert ID 'node-987'
```

**Response:** 
```
Executing custom query… Done. For advert 'node-987', the Legacy ID is '554433' and the Title is 'Titanium Mountain Bike'. Would you like to fetch the inventory quantity using another query?
```

## Capabilities

### Audit Product Data
Retrieve detailed product information, including pricing and variants, directly from the marketplace catalog.

### Review Order Financials
Track specific orders by listing recent invoices and extracting financial details like tax distributions and line items.

### Manage Vendor Networks
Fetch lists of third-party sellers and vendors to check their active status or current product listings.

### Track Logistics Flow
List and inspect shipment records to monitor where an order is in the fulfillment process across multiple sellers.

### Execute Custom Queries
Run complex, custom GraphQL queries against any specific data point or schema entity within the platform.

## Use Cases

### Auditing Seller Compliance
A Marketplace Manager needs to ensure no vendor is inactive. They ask their agent to run `list_sellers` and then filter the results to identify vendors who haven't listed any products recently, allowing them to address compliance issues immediately.

### Investigating a Missing Shipment
An Operations Engineer discovers an order is stuck. They prompt their agent to `list_shipments` using the order ID, tracing the physical movement of goods and pinpointing exactly which seller failed to update the tracking status.

### Deep Data Extraction for Reporting
A Developer needs a specific data point—the product's internal SKU linked to its GraphQL identifier. They use `graphql_query` to pull this precise, cross-referenced information that isn't exposed by the standard product listing tools.

### Reviewing Financial Discrepancies
A manager spots a tax discrepancy on an invoice. They ask for `list_invoices` to find the transaction, then use `get_invoice` to view the full payload and confirm exactly how the taxes were distributed across line items.

## Benefits

- Instead of generating a spreadsheet report to see vendor performance, you simply ask your agent to list vendors using the `list_sellers` tool. It gets you the data instantly.
- Stop hunting for order details in separate systems. You can use `list_invoices` and then dive deep into line items with `get_invoice`, giving you a complete financial picture of any sale.
- Need to know why an order is delayed? Use `list_shipments` to track the fulfillment lifecycle across multiple sellers, all in one conversation flow.
- Don't rely on fixed reports. With the `graphql_query` tool, you can fetch highly specific data points—like a legacy ID alongside a title—that standard tools miss.
- Verify your entire system integration stack by calling `list_webhooks`. You confirm if all automated event subscriptions are set up correctly, eliminating manual audit time.

## How It Works

The bottom line is you talk about what data you need, and the MCP handles talking to the marketplace backend for you.

1. Subscribe to this MCP and provide your Marketplacer API URL and API Key.
2. Connect this MCP to your preferred AI client, like Claude or Cursor.
3. Ask your agent a question—for example, 'What are the latest 5 invoices?'—and it executes the required tool call.

## Frequently Asked Questions

**How do I check vendor accounts using Marketplacer MCP?**
You use the `list_sellers` tool. This fetches a comprehensive list of all active vendors, allowing you to quickly audit their account statuses and verify who is currently on your platform.

**Can I track an order's journey with Marketplacer MCP?**
Yes, use the `list_shipments` tool. It retrieves detailed records of fulfillment, allowing you to monitor where an item is in its journey across the entire distributed seller network.

**Is the GraphQL query tool for general data or specific reports?**
The `graphql_query` tool is for highly customized data retrieval. Use it when standard listing tools don't expose a niche piece of information, allowing you to fetch precise data points across any schema entity.

**How do I check if my integrations are working?**
Use the `list_webhooks` tool. This audits your configured event subscriptions and webhooks, confirming that all automated connections are set up correctly without manual checks.

**Can I retrieve product details using GraphQL identifiers through my agent?**
Yes. Use the `get_advert` tool and provide the specific GraphQL Node ID. Your agent will fetch the full record, including descriptions, pricing arrays, and variants directly from the Marketplacer schema.

**How do I check recent orders on my marketplace through a conversation?**
The `list_invoices` tool allows your agent to retrieve recent order invoices. You'll see the amount, status, and associated seller for each order, helping you monitor high-level marketplace activity instantly.

**Can my agent run custom GraphQL queries against the Marketplacer endpoint?**
Absolutely. Use the `graphql_query` tool to execute sophisticated custom queries. You can provide the query string and optional JSON variables, and your agent will return the raw GraphQL response payload securely.