bol.com MCP by usefulapi
REMOTE · BOL-COM.USEFULAPI.IO
Read bol orders, returns, offers and inventory; update an offer’s stock, price or sale status.
Available components
Last scanned (4 hours ago)
Scores higher than 4% of remote servers
Reachable. Last reached 5 Nov 2026.
Category E-commerce
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not yet verified: we couldn't confirm whether this endpoint requires it. View diagnostics → Unverified
- HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability0
- Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly. See how to fix → View diagnostics → Fail
Schema Quality & AI Usability0
- Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.Unverified
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage0
- Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.Unverified
Tool Safety0
- Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.Unverified
Capabilities0
- Capabilities not yet verified: we couldn't read the endpoint's capabilities.Unverified
Unverified: 5 categories
Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Nov 26 −48
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.07 → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Schema quality: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- 31 Oct 26 +4
- Authorization: partial → pass ▲ security
- Stability: unverified → 0.03 ▲ functional
- MCP protocol: fail → pass ▲ functional
- New prompt “investigate_why_an_offer_is_not_for_sale” functional
- New prompt “reconcile_a_bol_invoice_with_its_transactions” functional
- New prompt “review_open_orders_and_their_shipments” functional
- New prompt “update_an_offer_after_reviewing_stock_or_prices” functional
- MCP protocol version: 2025-06-18 → 2025-11-25 functional
- Server version: 1.2.0 → 1.4.0 functional
- Server version: 1.1.0 → 1.2.0 functional
- Server version: 1.0.1 → 1.1.0 functional
- 30 Oct 26 62
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Probed https://bol-com.usefulapi.io/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=usefulapi.io | CN=WE1,O=Google Trust Services,C=US | 13 Sept 2026 | 12 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | d9be3287b0fde9630e825ba1f79bff3f |
| SANs: usefulapi.io, *.usefulapi.io | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of bol-com.usefulapi.io. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| io. | present | 38690 | 8 | Verified |
| usefulapi.io. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Inconclusive
We could not reach the endpoint well enough to judge its authorisation posture.
| Result | Inconclusive |
|---|---|
| HTTP status | 302 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://bol-com.usefulapi.io/mcp | Redirected | 302 | https://usefulapi.io/bol-com/ |
| http (plaintext) | http://bol-com.usefulapi.io/mcp | Inconclusive | 302 | http://bol-com.usefulapi.io/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
bol_get_commissions Calculate commissions ~77
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.
| Name | Type | Req | Description |
|---|---|---|---|
| products | array | yes | The products to calculate. |
No output schema declared.
No examples provided.
bol_get_competing_offers Competing offers for an EAN ~127
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.
| Name | Type | Req | Description |
|---|---|---|---|
| best_offer_only | boolean | – | true = only the best offer. |
| condition | string | – | Offer condition filter. |
| country_code | string | – | Webshop country (default NL). |
| ean | string | yes | EAN (8 to 14 digits). |
| page | integer | – | Page number, 1-200. |
No output schema declared.
No examples provided.
bol_get_invoice_specification Get an invoice specification ~95
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.
| Name | Type | Req | Description |
|---|---|---|---|
| invoice_id | string | yes | The invoice id (from bol_list_invoices). |
| page | integer | – | Page number, from 1 (default 1). Use the previous reply's next_page. |
No output schema declared.
No examples provided.
bol_get_offer Get an offer ~66
One offer by id (Offers API v11): condition, price bundles, stock, fulfilment, countries, product. GET /retailer/offers/{offer-id} (v11).
| Name | Type | Req | Description |
|---|---|---|---|
| offer_id | string | yes | The offer id (UUID, from bol_list_offers). |
No output schema declared.
No examples provided.
bol_get_offer_not_for_sale_reasons Why an offer is not for sale ~93
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).
| Name | Type | Req | Description |
|---|---|---|---|
| offer_id | string | yes | The offer id (UUID). |
No output schema declared.
No examples provided.
bol_get_order Get an order ~74
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}.
| Name | Type | Req | Description |
|---|---|---|---|
| order_id | string | yes | The bol order id (from bol_list_orders). |
No output schema declared.
No examples provided.
bol_get_performance_indicator Get a performance indicator ~105
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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | The indicator. |
| week | integer | yes | ISO week number, 1-53. |
| year | integer | yes | Year, e.g. 2026. |
No output schema declared.
No examples provided.
bol_get_process_status Get a process status ~71
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}.
| Name | Type | Req | Description |
|---|---|---|---|
| process_status_id | string | yes | The process status id. |
No output schema declared.
No examples provided.
bol_get_return Get a return ~55
One return by id: return items, reasons, handling results, the customer's details (personal data). GET /retailer/returns/{return-id}.
| Name | Type | Req | Description |
|---|---|---|---|
| return_id | string | yes | The return id (from bol_list_returns). |
No output schema declared.
No examples provided.
bol_get_sales_forecast Get a sales forecast ~77
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.
| Name | Type | Req | Description |
|---|---|---|---|
| offer_id | string | yes | The offer id (UUID). |
| weeks_ahead | integer | yes | Weeks ahead, 1-12. |
No output schema declared.
No examples provided.
bol_get_shipment Get a shipment ~65
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}.
| Name | Type | Req | Description |
|---|---|---|---|
| shipment_id | string | yes | The shipment id (from bol_list_shipments). |
No output schema declared.
No examples provided.
bol_list_inventory List FBB inventory ~148
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.
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | – | Page number, from 1 (default 1). Use the previous reply's next_page. |
| quantity | string | – | Quantity range "min-max", e.g. "0-10". |
| query | string | – | EAN or product title. |
| state | string | – | Stock type filter. |
| stock | string | – | Stock level filter. |
No output schema declared.
No examples provided.
bol_list_invoices List invoices ~108
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.
| Name | Type | Req | Description |
|---|---|---|---|
| period_end_date | string | – | Period end, yyyy-mm-dd. |
| period_start_date | string | – | Period start, yyyy-mm-dd (give both dates, max 31 days apart). |
No output schema declared.
No examples provided.
bol_list_offers List offers ~217
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).
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | The next_cursor of the previous reply. |
| eans | array | – | Only these EANs. |
| for_sale | boolean | – | true = only offers currently for sale, false = only those not for sale. |
| last_modified_since | string | – | Only offers modified since this UTC time, e.g. 2026-10-01T08:00:00Z. |
| offer_ids | array | – | Only these offer ids (UUIDs). |
| page_size | integer | – | Offers per page, 1-100. |
| reference | string | – | Only offers with this seller reference. |
No output schema declared.
No examples provided.
bol_list_orders List orders ~199
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.
| Name | Type | Req | Description |
|---|---|---|---|
| change_interval_minute | integer | – | Only order items changed in the last N minutes (1-60). |
| fulfilment_method | string | – | Fulfilled by the retailer (FBR, default), by bol (FBB) or both (ALL). |
| latest_change_date | string | – | Only order items last changed on this date, yyyy-mm-dd (up to 3 months back). |
| page | integer | – | Page number, from 1 (default 1). Use the previous reply's next_page. |
| status | string | – | Order status (default OPEN). |
No output schema declared.
No examples provided.
bol_list_returns List returns ~131
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.
| Name | Type | Req | Description |
|---|---|---|---|
| fulfilment_method | string | – | FBR or FBB. |
| handled | boolean | – | true = handled returns, false = returns still to handle. Set it explicitly. |
| page | integer | – | Page number, from 1 (default 1). Use the previous reply's next_page. |
No output schema declared.
No examples provided.
bol_list_shipments List shipments ~124
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.
| Name | Type | Req | Description |
|---|---|---|---|
| fulfilment_method | string | – | FBR or FBB (ignored when order_id is given). |
| order_id | string | – | Only the shipments of this order. |
| page | integer | – | Page number, from 1 (default 1). Use the previous reply's next_page. |
No output schema declared.
No examples provided.
bol_update_offer Update an offer ~250
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).
| Name | Type | Req | Description |
|---|---|---|---|
| offer_id | string | yes | The offer id (UUID). |
| on_hold | boolean | – | true = take the offer off sale (hold), false = list it for sale again. |
| prices | array | – | Replaces ALL price bundles: [{quantity: 1, unit_price: 9.99}, ...]. The first quantity must be 1; quantities rise, unit prices (incl. VAT, 2 decimals) fall. |
| reference | string | – | Your own reference for the offer (max 100 chars; empty clears it). |
| stock_amount | integer | – | Stock in your own warehouse (not FBB stock). |
| stock_managed_by_retailer | boolean | – | true = you manage stock levels; false = bol corrects stock for open orders. |
No output schema declared.
No examples provided.
How do I install the bol.com MCP by usefulapi server?
bol.com MCP by usefulapi is a hosted endpoint at https://bol-com.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · bol-com.usefulapi.io
claude mcp add --transport http io-usefulapi-bol-com 'https://bol-com.usefulapi.io/mcp'
What is the bol.com MCP by usefulapi server?
bol.com MCP by usefulapi is listed in the public MCP registry as io.usefulapi/bol-com. Read bol orders, returns, offers and inventory; update an offer’s stock, price or sale status. This page covers its hosted endpoint (https://bol-com.usefulapi.io/mcp).
Is the bol.com MCP by usefulapi server safe to use?
bol.com MCP by usefulapi scores 18 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the bol.com MCP by usefulapi server expose?
bol.com MCP by usefulapi exposes 18 tools: bol_list_orders, bol_get_order, bol_list_shipments, bol_get_shipment, bol_list_returns, and 13 more. Their descriptions and schemas cost roughly 2,082 tokens of context every time the server is loaded.
Does the bol.com MCP by usefulapi server require authentication?
Its publisher declares no required credentials for bol.com MCP by usefulapi. We have not been able to confirm that against the live endpoint, and a server can require authorisation without declaring it here.
Is the bol.com MCP by usefulapi server still maintained?
bol.com MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.