# ManoMano MCP

> ManoMano MCP lets you manage your entire seller account through natural conversation. Use this connector to update offer prices, track incoming orders, and audit fulfillment stock levels directly from your agent without logging into the marketplace dashboard.

## Overview
- **Category:** supply-chain
- **Price:** Free
- **Tags:** marketplace-management, order-fulfillment, inventory-management, pricing-optimization, logistics-tracking

## Description

Managing a major marketplace like ManoMano means juggling inventory, pricing, and order flow across multiple tabs. This MCP puts full control of your seller account right where you work. You can ask your agent to list every published offer or retrieve detailed metadata for specific items, including current stock and VAT-included prices. Need to adjust pricing? Just tell your AI client to update the price for an entire product line. When orders come in, track them all using simple commands; confirm pending shipments with `accept_order` or mark fulfilled goods by supplying tracking numbers via `ship_order`. Plus, you can check stock levels maintained through ManoFulfillment. If you’re looking for a central place to manage marketplace operations, connecting your account through Vinkius is the fastest way to get started.

## Tools

### list_offers
Retrieves a list of all active product offers currently published on ManoMano.

### get_offer
Fetches specific, detailed information for one identified offer, including its price, stock count, and SKU.

### update_offer_price
Changes the listed sale price of a specific product offer on ManoMano.

### update_offer_stock
Sets a new available stock count for a particular published offer.

### list_orders
Gathers a list of all orders received through the ManoMano platform.

### get_order
Retrieves comprehensive details for a specific order, including customer addresses and every line item purchased.

### accept_order
Changes the status of an order from pending to accepted within your seller account.

### ship_order
Marks an order as shipped by providing a valid carrier name and tracking number.

### list_categories
Provides a list of all root categories available in the ManoMano product catalog.

### list_brands
Retrieves a directory of established brands listed on the ManoMano marketplace.

### list_fulfillment_stock
Checks and reports current stock levels maintained by the external ManoFulfillment warehouse.

## Prompt Examples

**Prompt:** 
```
List all ManoMano orders received today
```

**Response:** 
```
I've retrieved 5 new orders. Highlights include Order #MM-123 (Amount: €45.00, Status: Pending) and Order #MM-456 (Amount: €120.00, Status: Accepted). Would you like to see the delivery address for the pending order?
```

**Prompt:** 
```
Update the stock for offer 'offer-987' to 50 units
```

**Response:** 
```
Updating inventory… I've successfully set the stock for offer 'offer-987' to 50 units. Your listing on ManoMano is now synchronized with this new quantity. Would you like me to check the current price as well?
```

**Prompt:** 
```
Show me the stock levels in ManoFulfillment
```

**Response:** 
```
Retrieving fulfillment stock… I've identified several items in the ManoMano managed warehouse. You have 150 units of SKU 'DRILL-01' and 45 units of SKU 'SAW-05'. No low-stock alerts detected for today.
```

## Capabilities

### Adjusting Offer Details
The agent updates an offer's price or changes its available stock count with simple instructions.

### Tracking and Processing Orders
You list all received orders, retrieve full customer details, and move order status from pending to shipped using tracking numbers.

### Auditing Inventory Status
The MCP lists all current published offers or checks stock levels held in the ManoFulfillment warehouse.

### Catalog Discovery
You enumerate available root category listings and registered brands to help map new products into your catalog structure.

## Use Cases

### The End-of-Day Audit
A manager needs to know which orders were received today and if they can be fulfilled. They ask their agent to run `list_orders` first, then check the delivery addresses using `get_order` for the top 5 most valuable pending items.

### The Price Correction
A competitor drops their pricing on a key item. The seller immediately asks the agent to run `list_offers`, identifies the target SKU, and then uses `update_offer_price` to beat the new low price instantly.

### The Fulfillment Check
Logistics needs confirmation on stock. They prompt the agent with a request for fulfillment levels; the system runs `list_fulfillment_stock`, confirming that 150 units of SKU 'DRILL-01' are available.

### The Shipment Confirmation
An order is ready to go. Instead of manually updating a status field, the seller prompts the agent to `ship_order`, providing the carrier and tracking number so the record updates automatically.

## Benefits

- Stop manually tracking stock. Use `list_fulfillment_stock` to get real-time visibility into items stored in the ManoFulfillment warehouse without logging out of your workspace.
- Never miss a sale due to outdated prices. You can tell your agent to use `update_offer_price` and adjust entire product lines instantly, keeping you competitive on the marketplace.
- Handle order backlogs immediately. Instead of clicking through dashboards, simply ask your AI client to process pending orders using `accept_order` or confirm shipment details with `ship_order`.
- Simplify complex data retrieval. Use `get_order` to pull a full record containing everything from the customer's name to the delivery address in one clean call.
- Maintain catalog integrity effortlessly. You can use `list_categories` and `list_brands` to map new products correctly, eliminating manual taxonomy setup time.

## How It Works

The bottom line is you get full control of complex seller tasks using plain English commands instead of navigating multiple web dashboards.

1. First, subscribe to this MCP on Vinkius and provide your ManoMano API Key.
2. Then, invoke the connector via your AI client (like Claude or Cursor) with a request—for example, asking to 'list all received orders'.
3. The agent executes the necessary tool calls and returns structured data about your marketplace operations directly into your chat window.

## Frequently Asked Questions

**How do I check stock levels using ManoMano MCP?**
You use `list_fulfillment_stock` to see what's currently held in the dedicated ManoFulfillment warehouse. This tool gives you an accurate count of your available inventory.

**Can I update prices for multiple products with ManoMano MCP?**
Yes. You don't have to list them one by one; you can tell the agent which product group needs a price adjustment, and it uses `update_offer_price` accordingly.

**What is the difference between listing orders and getting an order?**
Running `list_orders` gives you a summary of all recent activity. You use `get_order` when you need the full, deep details—like every single line item or the complete shipping address.

**Do I need to know SKUs for ManoMano MCP?**
While knowing an SKU helps, you can often reference offers by other identifiers. The agent is designed to handle different inputs when running tools like `get_offer` or `update_offer_stock`.

**How do I mark a shipment as sent using ManoMano MCP?**
You use the `ship_order` tool, making sure to provide both the carrier's name and the valid tracking number so the status updates correctly on the marketplace.