# Boloo (bol.com Retailer) MCP for AI Agents MCP

> Boloo (Bol.com Retailer) manages your entire bol.com store via a single AI connection. Your agent tracks open and handled orders, updates stock levels across offers, and checks global product data—all without you needing to log into the seller dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** retail-automation, order-fulfillment, stock-management, marketplace-integration, inventory-tracking

## Description

Managing an online shop requires juggling multiple dashboards: one for inventory, another for shipping status, and a third just for order history. Boloo gives your AI agent direct access to bol.com's retailer API, letting you handle all of that from natural conversation.

You can ask your agent to list every open order or check the current stock level for a specific product offer. It’ll pull the data instantly. Need to update pricing? Your agent handles that too. You even get global product details using just an EAN code, so you don't have to search bol.com's public catalog manually.

It's about getting operational visibility without the clicks. When you connect this MCP through Vinkius, your AI client gets a single point of control for coordinating order status, managing inventory, and handling product offers. You get back time, and accuracy.

## Tools

### cancel_order_item
Cancels a specific item in an order, requiring you to input a valid reason code.

### get_offer
Retrieves detailed information about one particular product offer.

### get_order
Gets complete details for a specific order ID.

### get_product_details
Retrieves general product information from the public catalog using an EAN code.

### list_offers
Lists all active and current product offers in your entire catalog.

### list_orders
Retrieves a list of open or already handled orders from your account.

### list_subscriptions
Shows all configured webhook subscriptions to verify event tracking setups.

### ship_order_item
Confirms the shipment status for a specific item within an order.

### update_offer_price
Updates the listed price for a selected product offer.

### update_offer_stock
Changes the available stock quantity for a specific product offer.

## Prompt Examples

**Prompt:** 
```
What's the status of my top 5 open orders?
```

**Response:** 
```
**Open Orders Summary**

| Order ID | Customer | Items Count | Status |
| :---: | :---: | :---: | :---: |
| #123456789 | John Doe | 3 | Pending Shipment |
| #987654321 | Jane Smith | 1 | Needs Stock Check |

Need me to confirm shipment for any of these? Just say the order ID.
```

**Prompt:** 
```
Can you check if EAN 8712345678901 is still listed and what its current lowest price is?
```

**Response:** 
```
**Product Info Retrieval**

*   **Title:** Wireless Gaming Mouse*
*   **Category:** Electronics*
*   **Global Status:** Active (via public catalog)
*   **Lowest Current Offer:** €45.00

This data is pulled from bol.com's public product index.
```

**Prompt:** 
```
I need to increase the stock for offer 99283-abc and also cancel order #111222333.
```

**Response:** 
```
**Action Log**

✅ **Stock Update:** Stock for offer `99283-abc` updated successfully to 75 units. This change is live now.
✅ **Order Action:** Order `#111222333` was canceled due to 'Invalid item'. The system recorded the cancellation.
```

## Capabilities

### Reviewing Order Status
List all open or handled orders to see what needs attention.

### Checking Product Offers
View details for a specific product offer, or list every active offer in your catalog.

### Adjusting Inventory and Pricing
Update the stock level or change the price for any listed offer.

### Confirming Shipments and Cancellations
Mark items as shipped, or cancel an order item while providing a valid reason code.

### Retrieving Product Data
Get general product information using a global EAN barcode number.

### Monitoring Webhooks
List all webhook subscriptions to verify your event data flow setup.

## Use Cases

### Processing a backlog of pending shipments
An ops manager notices three orders are stuck because shipping confirmation is missing. They ask their agent to review all open items and confirm shipment for Order #ABC12345, which triggers the `ship_order_item` tool.

### Correcting a stock discrepancy mid-sale
A seller realizes they sold more units than expected. They ask their agent to update the inventory for Offer 99283-abc to 50, executing `update_offer_stock` immediately so sales don't continue on bad data.

### Investigating a product listing error
A developer finds a product seems miscategorized. They use their agent to pull global details using the EAN code via `get_product_details` and confirm the correct category for troubleshooting.

### Handling an unexpected order cancellation
An agent detects a canceled order and needs to process it. They ask the agent to run `cancel_order_item`, specifying the reason code, which logs the closure correctly in the system.

## Benefits

- Instantly check order details using `list_orders` or get specific info with `get_order`, eliminating the need to navigate multiple tabs.
- Maintain perfect stock accuracy by calling `update_offer_stock` and `update_offer_price` directly from your chat interface.
- Streamline fulfillment by confirming shipments via `ship_order_item` or handling cancellations using `cancel_order_item` with a valid reason code.
- Gain product intelligence immediately; use `get_product_details` to pull global info just by knowing the EAN barcode number.
- Keep track of your integrations and data flow by listing webhooks with `list_subscriptions`, ensuring nothing gets missed.
- View all available products quickly using `list_offers` so you always know what's active in your catalog.

## How It Works

The bottom line is: you use your natural language conversation to trigger complex e-commerce actions directly through your AI client.

1. Subscribe to this MCP and provide your bol.com Client ID and Client Secret.
2. Connect the credentials to any compatible AI client, like Cursor or Claude.
3. Ask your agent a question about orders or stock levels; it executes the action using the connected API.

## Frequently Asked Questions

**How can I use the Boloo (bol.com Retailer) MCP to check my order history?**
You simply ask your agent to list open or handled orders. It pulls a complete, structured list of all pending and fulfilled sales data directly from bol.com’s system for you.

**Can the Boloo (bol.com Retailer) MCP help me manage my product stock levels?**
Yes. You can tell your agent to update the inventory count for any specific offer, ensuring that your listing data matches what you actually have in storage.

**I want to cancel an order item using Boloo (bol.com Retailer) MCP; do I need a reason code?**
Yes, the system requires a valid reason code when canceling an item. You just provide that reason in your prompt, and the agent handles the cancellation process correctly.

**Does the Boloo (bol.com Retailer) MCP let me update product prices?**
Absolutely. You can use the agent to update the price of any specific offer listed in your catalog, making sure pricing changes are immediate and accurate.

**What if I need product details for an item not currently listed? Can Boloo (bol.com Retailer) MCP help?**
The MCP can retrieve global product information using the EAN code, even if the item isn't actively selling on bol.com right now. This is great for planning.

**Can I monitor my webhook subscriptions with Boloo (bol.com Retailer) MCP?**
Yes, you can list all your configured webhooks in one go. This lets you verify that your automated event-driven data flow is set up and working correctly.