# Boloo MCP for AI Agents AI Agent Connect

> Boloo (Bol.com Retailer) MCP lets you manage your bol.com store through your AI agent. Track orders, update stock levels, and adjust prices for your product offers without leaving your chat interface. It connects directly to the bol.com Retailer API to handle the heavy lifting of e-commerce fulfillment and inventory management.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ChefEaEhlGw8XZZQubSOHJ1fO4W93cCnVNmrKjMN/ai-agent-connect
- **Tags:** retail-automation, order-fulfillment, stock-management, marketplace-integration, inventory-tracking

## Description

This Connector connects your bol.com Retailer account to your AI agent so you can manage your e-commerce operations through natural conversation. Managing a bol.com store usually means jumping between different dashboard tabs, constantly refreshing pages to see if an order came in, and manually updating stock levels to avoid overselling. This changes that by bringing your entire retail operation into your primary workspace. Instead of hunting for a specific order ID or digging through a list of offers to change a price, you just tell your agent what needs to happen. It handles the data fetching in the background so you can focus on moving products. Because Vinkius hosts this Connector, you can plug it into your existing workflow and start using natural language to oversee your Dutch e-commerce business. You can check your open orders, confirm shipments, and even look up global product details. It's about getting the right information at the right time without the friction of a traditional seller portal.

## Tools

### get_order
This tool pulls all the information for a specific order. It helps you see the full metadata for a single transaction.

### get_product_details
This tool fetches global product info from the public catalog using an EAN code. It is useful for quick spec checks.

### list_offers
This tool shows a complete list of all your active product offers. Use it to get a full dump of your current catalog.

### list_orders
This tool gets a list of all open or handled orders from your store. It helps you keep track of pending shipments.

### cancel_order_item
This tool cancels a specific item from an order. You must provide a valid reason code to complete the action.

### get_offer
This tool retrieves the specific details for a single product offer. Use it to see current pricing and availability.

### list_subscriptions
This tool views your active webhook subscriptions. Use it to verify that your event-driven data flow is active.

### ship_order_item
This tool confirms that an order item has been shipped. It helps you update your fulfillment status quickly.

### update_offer_price
This tool changes the price of a specific product offer. Use it to adjust your retail margins on the fly.

### update_offer_stock
This tool updates the current stock level for a specific product offer. It keeps your bol.com listings accurate.

## Prompt Examples

**Prompt:** 
```
Show me all the open orders I have right now.
```

**Response:** 
```
I've pulled your open orders from bol.com. You have 4 pending orders.

| Order # | Status | Items |
| :--- | :--- | :--- |
| #8821 | Pending | 2 |
| #9930 | Awaiting Shipment | 1 |

Would you like me to get the details for any of these?
```

**Prompt:** 
```
Update the price for offer 12345 to 29.99 Euros.
```

**Response:** 
```
Done. I've updated the price for offer 12345 to €29.99. The change is now live on your bol.com store.
```

**Prompt:** 
```
Get the info for EAN 8712345678901.
```

**Response:** 
```
I found the product details for EAN 8712345678901:

* **Product:** Wireless Gaming Mouse
* **Category:** Electronics
* **Details:** High-precision sensor, RGB lighting.

Would you like to see the current offers for this product?
```

## Capabilities

### Track open and handled orders
See every pending order and its specific details in one view.

### Update stock levels
Change your inventory counts instantly to keep your listings accurate.

### Adjust offer prices
Modify the selling price of your products across the bol.com marketplace.

### Confirm shipments
Mark items as shipped to keep your logistics moving smoothly.

### Retrieve product data
Get global details for any product using its EAN code.

### Monitor webhooks
View your active subscriptions to ensure your data stays in sync.

## Use Cases

### Quick stock adjustments for high-volume sales
A seller notices a sudden spike in sales for a specific item and asks the agent to use update_offer_stock to reflect the new quantities immediately.

### Monitoring high-priority shipment statuses
An operations manager needs to check the status of a high-priority shipment and uses get_order to see the metadata and ship_order_item to confirm it.

### Auditing active product catalog
A store owner wants to see what products are currently active and uses list_offers to get a full dump of their catalog for a pricing audit.

### Verifying webhook event flow
A developer needs to check if the webhook is firing correctly and uses list_subscriptions to verify the event flow is active.

## Benefits

- Stop manual stock updates by using update_offer_stock to keep your bol.com listings accurate in real-time.
- Reduce order processing time by using list_orders to see everything pending in one glance.
- Get instant product data using get_product_details to quickly find specs for any EAN code.
- Simplify logistics with ship_order_item to confirm deliveries without navigating complex menus.
- Keep your data in sync by using list_subscriptions to monitor your webhook health.
- Control your margins easily by using update_offer_price to adjust costs on the fly.

## How It Works

The bottom line is you get a natural language interface for your bol.com retail operations.

1. Subscribe to the Boloo MCP on Vinkius.
2. Provide your bol.com Client ID and Client Secret.
3. Ask your agent to check orders or update stock.

## Frequently Asked Questions

**Can the Boloo MCP help me manage my bol.com store?**
Yes, it lets you manage your store directly through your AI client. You can handle orders, update stock, and manage prices without ever opening the seller dashboard.

**How do I use the Boloo MCP to update my inventory?**
Just tell your AI agent which product needs a stock update. It will use the correct tools to change your bol.com inventory levels in real-time.

**Does the Boloo MCP work for order fulfillment?**
Yes, it includes tools to list your open orders, retrieve specific order metadata, and confirm shipments to keep your fulfillment process moving.

**Can I use Boloo MCP to see my product prices?**
You can list all your active product offers or get details on a specific one. This lets you monitor your pricing across the bol.com marketplace easily.

**How does the Boloo MCP handle product information?**
It can pull global product details using an EAN code. This is great for quickly checking specs or details from the public bol.com catalog.

**Is the Boloo MCP good for tracking my webhooks?**
Yes, it allows you to list your active webhook subscriptions. This helps you verify that your event-driven data flow is working correctly.

**Can I check for new open orders using the agent?**
Yes! Use the `list_orders` tool with the status 'OPEN'. Your agent will fetch all orders that are currently awaiting handling in your bol.com account.

**How do I update the stock level for an existing product offer?**
Simply ask the agent to `update_offer_stock` and provide the Offer ID and the new amount. It will update the availability on the bol.com platform instantly.

**Does the integration allow shipping items through bol.com Logistics?**
Yes. Use the `ship_order_item` tool to confirm that an item has been handed over to the carrier. You will need to provide a shipment reference and the carrier details.