# Marketplacer MCP for AI Agents AI Agent Connect

> Marketplacer MCP lets you manage your enterprise marketplace through natural conversation. List products, audit seller networks, track orders, and run custom GraphQL queries against your Marketplacer instance from any AI client.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_6kGQPb48BxNbiCoF4NWbNU4uxypG6gkKoithypP4/ai-agent-connect
- **Tags:** marketplace-management, dropshipping, product-catalog, seller-network, enterprise-commerce

## Description

This Marketplacer MCP lets you take control of your enterprise marketplace operations by connecting your instance directly to your AI client. Instead of jumping between different tabs to find order statuses or vendor details, you can just ask your agent to pull that information for you. You can list products, audit your seller network, and track shipments across your distributed network without leaving your workspace. If you need to dig into the specifics, you can pull detailed invoice payloads or navigate through complex category trees to see how your items are organized. It even handles the heavy lifting of running custom GraphQL queries to get exact data points from any schema entity. It's a practical way to handle the data-heavy side of marketplace management without the manual overhead. You'll find this listed in the Vinkius catalog as a way to put your marketplace data into a conversational workflow.

## Tools

### list_adverts
List all products currently in your Marketplacer instance. This helps you see your full catalog at a glance.

### list_webhooks
List all configured event subscriptions and webhooks. This ensures your automated integrations are still active.

### get_advert
Fetch the specific details for a single product using its node ID. It's the fastest way to check pricing or variants.

### get_invoice
Pull the detailed payload for a specific invoice. This shows you the exact line items and tax distributions.

### list_sellers
Fetch a list of all vendors and third-party sellers. This is great for auditing your active seller network.

### list_categories
View the category taxonomies and product hierarchies. Use this to understand how your marketplace is organized.

### list_shipments
List and inspect shipment records across your network. Use this to track the fulfillment lifecycle of your orders.

### graphql_query
Run standard GraphQL queries against your Marketplacer endpoint. This lets you fetch literal data points from any schema entity.

### list_invoices
Get a list of all registered orders on the platform. Use this to keep a pulse on your daily sales volume.

## Prompt Examples

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

**Response:** 
```
I've retrieved the latest 5 invoices from your Marketplacer instance:

| Invoice ID | Amount | Seller | Status |
| :--- | :--- | :--- | :--- |
| #INV-123 | $150.00 | Seller A | Paid |
| #INV-456 | $85.50 | Seller B | Pending |
| #INV-789 | $210.00 | Seller C | Paid |
| #INV-101 | $45.00 | Seller A | Paid |
| #INV-102 | $120.00 | Seller D | Paid |

Would you like to see the shipment status for any of these?
```

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

**Response:** 
```
Searching your seller network... I've identified 3 vendors matching 'Outdoor':

* **Outdoor Adventure Gear** (ID: sel-123)
* **Premium Outdoor Living** (ID: sel-456)
* **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**, here are the details:
* **Title**: Titanium Mountain Bike
* **Legacy ID**: 554433

Would you like to fetch the inventory quantity using another query?
```

## Capabilities

### List marketplace products
See all adverts in your marketplace at a glance.

### Get specific product details
Pull pricing, variants, and descriptions for a single item using its node ID.

### Track all marketplace orders
View a list of all registered invoices on your platform.

### View invoice details
Get the full payload for a specific order including line items and tax distributions.

### Audit vendor networks
Enumerate all third-party sellers and vendors active on your platform.

### Browse category taxonomies
Explore your marketplace's architectural taxonomy and product hierarchies.

### Monitor shipment records
Track the fulfillment lifecycle of orders across your distributed seller network.

### Audit webhooks
Check your configured event subscriptions and automated integrations.

### Run custom GraphQL queries
Execute native GraphQL queries to fetch literal data points across any schema entity.

## Use Cases

### Auditing Vendor Performance
A manager asks their agent to list all sellers and then checks the shipment records for the top three to see their fulfillment rates.

### Testing GraphQL Schemas
A developer uses graphql_query to verify that a new product attribute is appearing correctly in the marketplace data.

### Rapid Order Troubleshooting
An ops lead asks for the last 5 invoices and then uses get_invoice to see the tax distribution on a specific problematic order.

### Catalog Architecture Review
A category lead uses list_categories to see how many items are assigned to different branches of the marketplace taxonomy.

## Benefits

- Stop digging through dashboards to find order data. Use list_invoices and get_invoice to get specific order details instantly.
- Audit your seller network without manual exports. Use list_sellers to see who is active on your platform right now.
- Navigate complex product hierarchies easily. Use list_categories to understand your taxonomy without clicking through nested menus.
- Monitor fulfillment in real time. Use list_shipments to track the lifecycle of orders across your distributed network.
- Verify your data mappings quickly. Use graphql_query to fetch specific attributes and ensure your product data is accurate.
- Keep your integrations healthy. Use list_webhooks to audit your event subscriptions and ensure they are functioning correctly.

## How It Works

The bottom line is you get a conversational interface for your entire Marketplacer marketplace infrastructure.

1. Subscribe to the Connector and provide your Marketplacer API URL and API Key.
2. Connect your preferred AI client to the Marketplacer instance.
3. Ask your agent to perform tasks like listing shipments or auditing seller statuses.

## Frequently Asked Questions

**Can I use the Marketplacer MCP to manage my products?**
Yes. You can use your agent to list all products in your catalog, get specific details for any item, and navigate your category taxonomies.

**How do I audit my seller network with Marketplacer?**
You can ask your agent to enumerate all third-party sellers and vendors. This allows you to quickly see who is active on your platform.

**Can the Marketplacer MCP track my marketplace shipments?**
Yes, it can list and inspect shipment records. This helps you track the fulfillment lifecycle of orders across your entire seller network.

**Does Marketplacer MCP support custom GraphQL queries?**
Yes, it supports standard GraphQL queries. This lets you fetch specific data points from any schema entity that isn't covered by the standard tools.

**How can I check my webhooks using Marketplacer?**
You can use your agent to audit all configured event subscriptions and webhooks to ensure your automated integrations are working correctly.

**Can I use Marketplacer MCP to see my category taxonomy?**
Yes. It lets you explore your marketplace's architectural taxonomy and product hierarchies to understand how your items are distributed.

**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.