# Sharetribe MCP for AI Agents AI Agent Connect

> Sharetribe MCP lets your AI agent manage your marketplace autonomously. It handles listing approvals, transaction updates, and user moderation. Use it to automate the heavy lifting of running a peer-to-peer site without clicking through complex admin panels. It's built for high-volume sellers who need to keep their catalogs fresh and their orders moving without the manual overhead.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_n2ASGkEvXnBMIcMaI8QWYfwLSPBCxgVzPEZqfYak/ai-agent-connect
- **Tags:** marketplace-management, transaction-routing, user-moderation, peer-to-peer, listing-management, community-governance

## Description

This Connector gives your AI agent the keys to your Sharetribe marketplace. Instead of clicking through endless admin dashboards, you can just tell your agent to handle the dirty work. It acts like a full-time operations manager that lives inside your AI client. You can have it scan new listings for compliance, push orders through different fulfillment stages, and keep an eye on community behavior. Because it connects directly to the Sharetribe Integration API, your agent understands the specific logic of your marketplace. When you use this through the Vinkius catalog, you're moving from manual data entry to conversational oversight. You'll spend less time auditing logs and more time growing your business. It handles the repetitive stuff like checking user profiles or moving a transaction from "paid" to "shipped" so you don't have to. It makes the entire lifecycle of a marketplace entry manageable through a single chat window. You can verify that every vendor is meeting your standards, ensure that payments are moving along correctly, and maintain a healthy environment for your buyers and sellers simultaneously. It turns a complex administrative burden into a simple series of commands.

## Tools

### approve_listing
Approves a pending listing. This allows you to push vetted entries live on your marketplace.

### get_listing
Retrieves details for a specific listing. Use this to inspect the specifics of any marketplace entry.

### get_transaction
Retrieves details for a specific transaction. This helps you check the current state of a specific order.

### get_user
Retrieves details for a specific user. Use this to audit behavioral profiles and user history.

### list_listings
Lists marketplace listings. This provides a full view of all items currently available on your platform.

### list_reviews
Lists marketplace reviews. Use this to scan community feedback and maintain a healthy environment.

### list_transactions
Lists marketplace transactions. This lets you see all ongoing or completed orders in one place.

### list_users
Lists marketplace users. This allows you to scan the entire user base for moderation purposes.

### transition_transaction
Transitions a transaction to a new state. Use this to move orders from one fulfillment stage to another.

## Prompt Examples

**Prompt:** 
```
Look at our new listings and tell me if any look like they need a review before we go live.
```

**Response:** 
```
I've scanned the recent submissions. Here's what I found:

| Listing | Status | Notes |
| :--- | :--- | :--- |
| Vintage Bicycle | Pending | Needs verification of ownership |
| Studio Apartment | Pending | Looks complete, ready for approval |
| Leather Jacket | Pending | Missing price details

Would you like me to approve the Studio Apartment now?
```

**Prompt:** 
```
I have a customer who's complaining about a late delivery. Can you find their recent transactions?
```

**Response:** 
```
I found the following recent transaction for that user:

**Order ID:** 9c42c2-8491-a9f
**Status:** `transition/preauthorized`
**Item:** Vintage Bicycle Framework
**Last Update:** 2 hours ago

It looks like the order is still in the preauthorization stage. Should I move it to 'processing' for you?
```

**Prompt:** 
```
Give me a summary of all the reviews we got this week so I can see the general vibe.
```

**Response:** 
```
Here is the summary of community feedback from the last 7 days:

*   **Total Reviews:** 24
*   **Average Rating:** 4.7/5
*   **Sentiment:** Very positive.

**Key Highlights:**
*   Most users praised the fast shipping times.
*   Two users mentioned a slight delay in the 'preauthorized' stage.
*   No reports of fraud or community violations were detected.
```

## Capabilities

### Approve new listings
Publish pending marketplace entries to your live catalog automatically.

### Update transaction statuses
Move orders through various fulfillment stages using plain language.

### Audit user behavior
Inspect user profiles to identify and manage problematic accounts.

### Moderate community reviews
Monitor and manage feedback from your marketplace users.

### Fetch marketplace data
Retrieve comprehensive details on listings, users, and orders.

## Use Cases

### Stuck Order Fulfillment
An order is stuck in a preauthorized state. You ask your agent to move it to confirmed status based on your instructions.

### Batch Listing Approval
You have a queue of new items. You tell your agent to find the pending ones and publish them to the live site.

### User Investigation
A user reports a scam. You ask your agent to check their history and past ratings to see if they are a repeat offender.

### Inventory Audit
You need to know what is currently for sale. You ask your agent to summarize the current stock levels for you.

## Benefits

- You can approve pending listings instantly to keep your catalog fresh and updated for new customers.
- You stop manually updating orders because your agent moves them through the pipeline automatically.
- You can audit user behavior to spot problematic accounts before they cause issues for your community.
- You manage community sentiment by pulling all feedback to see what people are saying about your site.
- You get a birds-eye view of your entire site to monitor health and growth without opening a single tab.

## How It Works

The bottom line is you get a conversational interface for your entire marketplace admin panel.

1. Connect your Sharetribe API keys to the Connector via the Vinkius dashboard.
2. Open your preferred AI client and point it to the Sharetribe MCP.
3. Give your agent commands like "approve all pending listings" to see it work.

## Frequently Asked Questions

**How does the Sharetribe MCP help with my marketplace?**
It gives your AI agent the ability to perform admin tasks like approving listings and updating orders using plain English. You get to skip the complex dashboard and manage your site through conversation.

**Can I use the Sharetribe MCP to moderate my community?**
Yes. You can have your agent scan user profiles and reviews to identify and manage problematic behavior on your platform.

**Does the Sharetribe MCP handle transaction updates?**
It does. Your agent can move transactions between different states like "confirmed" or "complete" based on your instructions.

**How do I get my agent to approve new listings?**
Just tell your agent to find all pending listings and approve them. It will use the Connector to scan your catalog and push the vetted entries live.

**Can the Sharetribe MCP help me audit my users?**
Yes, it can pull specific user details so you can investigate behavioral profiles and keep your marketplace safe.

**Is the Sharetribe MCP good for high-volume marketplaces?**
It's ideal for high-volume sites because it automates repetitive tasks like order routing and listing moderation that would normally take hours of manual clicking.

**Can the AI forcefully complete an active marketplace payment transition?**
Absolutely. Through the `transition_transaction` method, your prompt can dictate the order pipeline. Ensure you pass the specific UUID of the order and the explicit, configured transition name (e.g., "transition/accept" or "transition/complete") to force the lifecycle into its subsequent operational phase immediately.

**Why use the Integration API instead of the Marketplace API?**
Because the `Integration API` is the unadulterated administrator backend designed for secure backend logic rather than client interfaces. This permits system-level moderation, transaction configuration, and override state.

**Can this integration modify review ratings directly?**
Currently, the integration specifically implements `list_reviews` as a query mechanism tailored exclusively around monitoring and auditing capabilities. It does not actively expose a write mutation structurally to alter or destroy existing community integrity ratings.