bol.com MCP by usefulapi MCP Server

by usefulapi Your server? Claim it

answering

bol.com MCP by usefulapi is answering right now. Last checked 1 min ago. It exposes 18 tools. Last commit 1 Nov 2026.

Read bol orders, returns, offers and inventory; update an offer’s stock, price or sale status.

Uptime history 38 hours of history

38 hours agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

216 ms

Response time

average over 24h

Stars

last commit 1 Nov 2026

What changed 4

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 31 October 2026. No other catalogue keeps this.

31 Oct a tool changed version4 times that day

and 3 more, back to 31 October 2026

Nothing serious here today

Today is the operative word: we check bol.com MCP by usefulapi every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 1 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add bol-com --transport http https://bol-com.usefulapi.io/mcp

Settings → Connectors → Add custom connector, then paste this address

https://bol-com.usefulapi.io/mcp

~/.codex/config.toml

[mcp_servers.bol-com]
url = "https://bol-com.usefulapi.io/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "bol-com": {
      "url": "https://bol-com.usefulapi.io/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "bol-com": {
      "type": "http",
      "url": "https://bol-com.usefulapi.io/mcp"
    }
  }
}

Available tools 18

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

bol

bol_get_commissions

Calculate bol's commission for up to 100 products: for each EAN, a selling price and optionally a condition, returns the fixed amount, the percentage, total cost and any reductions. Read-only (a POST because of the request body). POST /retailer/commission.

bol_get_competing_offers

The offers on bol.com for one EAN from all retailers: price, condition, fulfilment, the best offer. Optionally only the best offer or one condition and country. GET /retailer/products/{ean}/offers.

bol_get_invoice_specification

The transactions (sales, commissions, shipping, returns) behind one bol invoice, as JSON, up to 25,000 lines per page. GET /retailer/invoices/{invoice-id}/specification.

bol_get_offer

One offer by id (Offers API v11): condition, price bundles, stock, fulfilment, countries, product. GET /retailer/offers/{offer-id} (v11).

bol_get_offer_not_for_sale_reasons

The reasons an offer is not for sale per country (an offer that is for sale everywhere has none) (content, price, stock, shop status, selling rights, on hold, assortment policy), each with a code and description. GET /retailer/offers/{offer-id}/not-for-sale-reasons (v11).

bol_get_order

One order by id: the order items (with their order item ids), prices, quantities, fulfilment, the buyer's shipment and billing details (personal data) and the latest delivery dates. GET /retailer/orders/{order-id}.

bol_get_performance_indicator

The seller's weekly measurements of one bol performance indicator (cancellations, fulfilment, phone availability, response time, case/item ratio, track and trace, returns, reviews) for an ISO year and week. GET /retailer/insights/performance/indicator.

bol_get_process_status

The status of an asynchronous bol process (a write that answered 202) by its process status id: PENDING, SUCCESS, FAILURE or TIMEOUT, with the error message on failure. GET /shared/process-status/{process-status-id}.

bol_get_return

One return by id: return items, reasons, handling results, the customer's details (personal data). GET /retailer/returns/{return-id}.

bol_get_sales_forecast

bol's sales forecast for one offer: expected sales on the whole bol.com platform for the next 1-12 weeks. GET /retailer/insights/sales-forecast.

bol_get_shipment

One shipment by id: shipment date, order items, transport and track and trace details, the buyer's delivery address (personal data). GET /retailer/shipments/{shipment-id}.

bol_list_inventory

Fulfilment by bol (FBB/LVB) inventory only, not your own stock (50 per page): EAN, title, regular and graded stock, and the stock level. Filter by EAN or title, stock level, stock type or a quantity range. GET /retailer/inventory.

bol_list_invoices

List bol invoices (the seller's statements from bol), by default the past 4 weeks: invoice id, issue date, type, period and the media types it can be downloaded in. Pass both dates to look further back (max 31 days). GET /retailer/invoices.

bol_list_offers

List the seller's offers (Offers API v11): offer id, EAN, condition, price bundles, stock, fulfilment, on-hold flag and last-modified time. Filter by offer ids, EANs, your reference, for-sale state or last-modified time. Cursor paging: pass the previous reply's next_cursor. GET /retailer/offers (v11).

bol_list_orders

List the seller's bol orders (50 per page), each with its order items, EANs, quantities, prices, fulfilment method and the buyer's shipment details (personal data). By default only OPEN orders fulfilled by the retailer (FBR). Use change_interval_minute or latest_change_date to poll for recent changes. GET /retailer/orders.

bol_list_returns

List customer returns (RMA): return id, registration date, fulfilment method and the return items with their handling status. Set handled explicitly: true = handled returns (newest first), false = returns still to handle (oldest first); bol documents no default. GET /retailer/returns.

bol_list_shipments

List shipments up to 3 months old, newest first (50 per page): shipment id, date, the order items shipped and the transport (track and trace). Filter by order_id OR fulfilment_method (order_id wins). GET /retailer/shipments.

bol_update_offer

WRITE: change an existing offer on bol (Offers API v11 PATCH): put it on hold or back on sale, set your reference, replace its price bundles and/or its own stock. Only the fields you pass change. A price or stock change goes live on bol.com. Use bol_list_offers first to see the current values. PATCH /retailer/offers/{offer-id} (v11).

Endpoints

URL	Transport	State	Latency	Checked
https://bol-com.usefulapi.io/mcp	streamable-http	answering	149 ms	1 min ago

Alternatives to bol.com MCP by usefulapi

same job, measured the same way

SOS Inventory MCP by usefulapi

by usefulapi

Read SOS Inventory stock and orders; create customers, items and purchase or sales orders.

19 tools answering

IdoSell MCP by usefulapi

by usefulapi

Search orders, products, stock, customers and returns; set order status in IdoSell.

13 tools answering

Finale Inventory MCP by usefulapi

by usefulapi

Read Finale Inventory products, stock, orders and shipments; create draft purchase orders.

13 tools answering

PlentyONE MCP by usefulapi

by usefulapi

Review PlentyONE orders, items, stock and contacts; add comments and update order status.

18 tools answering

Sellasist MCP by usefulapi

by usefulapi

Read Sellasist orders, products, stock, customers, invoices, returns; add order notes, set status.

27 tools answering

Linnworks MCP by usefulapi

by usefulapi

Read Linnworks inventory, stock and orders; set stock levels and add order notes.

17 tools answering

Megaventory MCP by usefulapi

by usefulapi

Read Megaventory products, stock, orders and partners; create clients, sales and purchase orders.

20 tools answering

SalesBinder MCP by usefulapi

by usefulapi

Read SalesBinder customers, inventory, warehouse locations, invoices and sales orders.

7 tools answering

bol.com MCP by usefulapi — questions

Answers built from our own checks of this server.

What can bol.com MCP by usefulapi do?

It exposes 18 tools, read directly from the server on our last check. Among them: bol_get_commissions, bol_get_competing_offers, bol_get_invoice_specification, bol_get_offer, bol_get_offer_not_for_sale_reasons, bol_get_order and 12 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is bol.com MCP by usefulapi working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 216 ms. The bar chart above shows every period we have measured.

How do I connect bol.com MCP by usefulapi?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does bol.com MCP by usefulapi need an API key?

No. bol.com MCP by usefulapi completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 18 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is bol.com MCP by usefulapi?

It answers our handshake in 216 ms on average, which is faster than 65% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is bol.com MCP by usefulapi open source?

The code is open source: it is published under the MIT licence, written in JavaScript, 1 stars on GitHub and 1 open issue. The licence covers the code in the repository, not the hosted service at bol-com.usefulapi.io, which runs on its operator's own terms.