bol.com MCP by usefulapi is an MCP server published by io.usefulapi, hosted at bol-com.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 18 tools, including bol_list_orders, bol_get_order, bol_list_shipments, bol_get_shipment, bol_list_returns.
Read bol orders, returns, offers and inventory; update an offer’s stock, price or sale status.
4,310 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Use the previous reply's next_page. |
| status | string | Order status (default OPEN). |
| 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). |
| change_interval_minute | integer | Only order items changed in the last N minutes (1-60). |
{
"name": "bol_list_orders",
"title": "List orders",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Use the previous reply's next_page.",
"exclusiveMinimum": 0
},
"status": {
"enum": [
"OPEN",
"SHIPPED",
"ALL"
],
"type": "string",
"description": "Order status (default OPEN)."
},
"fulfilment_method": {
"enum": [
"FBR",
"FBB",
"ALL"
],
"type": "string",
"description": "Fulfilled by the retailer (FBR, default), by bol (FBB) or both (ALL)."
},
"latest_change_date": {
"type": "string",
"description": "Only order items last changed on this date, yyyy-mm-dd (up to 3 months back)."
},
"change_interval_minute": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "Only order items changed in the last N minutes (1-60)."
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | The bol order id (from bol_list_orders). |
{
"name": "bol_get_order",
"title": "Get an order",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The bol order id (from bol_list_orders)."
}
}
},
"annotations": {
"title": "Get an order",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Use the previous reply's next_page. |
| order_id | string | Only the shipments of this order. |
| fulfilment_method | string | FBR or FBB (ignored when order_id is given). |
{
"name": "bol_list_shipments",
"title": "List shipments",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Use the previous reply's next_page.",
"exclusiveMinimum": 0
},
"order_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Only the shipments of this order."
},
"fulfilment_method": {
"enum": [
"FBR",
"FBB"
],
"type": "string",
"description": "FBR or FBB (ignored when order_id is given)."
}
}
},
"annotations": {
"title": "List shipments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| shipment_id * | string | The shipment id (from bol_list_shipments). |
{
"name": "bol_get_shipment",
"title": "Get a shipment",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shipment_id"
],
"properties": {
"shipment_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The shipment id (from bol_list_shipments)."
}
}
},
"annotations": {
"title": "Get a shipment",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Use the previous reply's next_page. |
| handled | boolean | true = handled returns, false = returns still to handle. Set it explicitly. |
| fulfilment_method | string | FBR or FBB. |
{
"name": "bol_list_returns",
"title": "List returns",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Use the previous reply's next_page.",
"exclusiveMinimum": 0
},
"handled": {
"type": "boolean",
"description": "true = handled returns, false = returns still to handle. Set it explicitly."
},
"fulfilment_method": {
"enum": [
"FBR",
"FBB"
],
"type": "string",
"description": "FBR or FBB."
}
}
},
"annotations": {
"title": "List returns",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One return by id: return items, reasons, handling results, the customer's details (personal data). GET /retailer/returns/{return-id}.
| Parameter | Type | Description |
|---|---|---|
| return_id * | string | The return id (from bol_list_returns). |
{
"name": "bol_get_return",
"title": "Get a return",
"description": "One return by id: return items, reasons, handling results, the customer's details (personal data). GET /retailer/returns/{return-id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"return_id"
],
"properties": {
"return_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The return id (from bol_list_returns)."
}
}
},
"annotations": {
"title": "Get a return",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| eans | array | Only these EANs. |
| cursor | string | The next_cursor of the previous reply. |
| for_sale | boolean | true = only offers currently for sale, false = only those not for sale. |
| offer_ids | array | Only these offer ids (UUIDs). |
| page_size | integer | Offers per page, 1-100. |
| reference | string | Only offers with this seller reference. |
| last_modified_since | string | Only offers modified since this UTC time, e.g. 2026-10-01T08:00:00Z. |
{
"name": "bol_list_offers",
"title": "List offers",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"eans": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{8,14}$",
"description": "EAN (8 to 14 digits)."
},
"maxItems": 50,
"description": "Only these EANs."
},
"cursor": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The next_cursor of the previous reply."
},
"for_sale": {
"type": "boolean",
"description": "true = only offers currently for sale, false = only those not for sale."
},
"offer_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "An offer id."
},
"maxItems": 50,
"description": "Only these offer ids (UUIDs)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Offers per page, 1-100."
},
"reference": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only offers with this seller reference."
},
"last_modified_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$",
"description": "Only offers modified since this UTC time, e.g. 2026-10-01T08:00:00Z."
}
}
},
"annotations": {
"title": "List offers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One offer by id (Offers API v11): condition, price bundles, stock, fulfilment, countries, product. GET /retailer/offers/{offer-id} (v11).
| Parameter | Type | Description |
|---|---|---|
| offer_id * | string | The offer id (UUID, from bol_list_offers). |
{
"name": "bol_get_offer",
"title": "Get an offer",
"description": "One offer by id (Offers API v11): condition, price bundles, stock, fulfilment, countries, product. GET /retailer/offers/{offer-id} (v11).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"offer_id"
],
"properties": {
"offer_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The offer id (UUID, from bol_list_offers)."
}
}
},
"annotations": {
"title": "Get an offer",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| offer_id * | string | The offer id (UUID). |
{
"name": "bol_get_offer_not_for_sale_reasons",
"title": "Why an offer is not for sale",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"offer_id"
],
"properties": {
"offer_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The offer id (UUID)."
}
}
},
"annotations": {
"title": "Why an offer is not for sale",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| 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. |
| on_hold | boolean | true = take the offer off sale (hold), false = list it for sale again. |
| offer_id * | string | The offer id (UUID). |
| 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. |
{
"name": "bol_update_offer",
"title": "Update an offer",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"offer_id"
],
"properties": {
"prices": {
"type": "array",
"items": {
"type": "object",
"required": [
"quantity",
"unit_price"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 24,
"minimum": 1
},
"unit_price": {
"type": "number",
"maximum": 9999,
"minimum": 1
}
}
},
"maxItems": 4,
"minItems": 1,
"description": "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."
},
"on_hold": {
"type": "boolean",
"description": "true = take the offer off sale (hold), false = list it for sale again."
},
"offer_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The offer id (UUID)."
},
"reference": {
"type": "string",
"maxLength": 100,
"description": "Your own reference for the offer (max 100 chars; empty clears it)."
},
"stock_amount": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Stock in your own warehouse (not FBB stock)."
},
"stock_managed_by_retailer": {
"type": "boolean",
"description": "true = you manage stock levels; false = bol corrects stock for open orders."
}
}
},
"annotations": {
"title": "Update an offer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Use the previous reply's next_page. |
| query | string | EAN or product title. |
| state | string | Stock type filter. |
| stock | string | Stock level filter. |
| quantity | string | Quantity range "min-max", e.g. "0-10". |
{
"name": "bol_list_inventory",
"title": "List FBB inventory",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Use the previous reply's next_page.",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "EAN or product title."
},
"state": {
"enum": [
"REGULAR",
"GRADED"
],
"type": "string",
"description": "Stock type filter."
},
"stock": {
"enum": [
"SUFFICIENT",
"INSUFFICIENT"
],
"type": "string",
"description": "Stock level filter."
},
"quantity": {
"type": "string",
"pattern": "^\\d+-\\d+$",
"description": "Quantity range \"min-max\", e.g. \"0-10\"."
}
}
},
"annotations": {
"title": "List FBB inventory",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | 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). |
{
"name": "bol_list_invoices",
"title": "List invoices",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"period_end_date": {
"type": "string",
"description": "Period end, yyyy-mm-dd."
},
"period_start_date": {
"type": "string",
"description": "Period start, yyyy-mm-dd (give both dates, max 31 days apart)."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Use the previous reply's next_page. |
| invoice_id * | string | The invoice id (from bol_list_invoices). |
{
"name": "bol_get_invoice_specification",
"title": "Get an invoice specification",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Use the previous reply's next_page.",
"exclusiveMinimum": 0
},
"invoice_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The invoice id (from bol_list_invoices)."
}
}
},
"annotations": {
"title": "Get an invoice specification",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| products * | array | The products to calculate. |
{
"name": "bol_get_commissions",
"title": "Calculate commissions",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"products"
],
"properties": {
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"ean",
"unit_price"
],
"properties": {
"ean": {
"type": "string",
"pattern": "^\\d{8,14}$",
"description": "EAN (8 to 14 digits)."
},
"condition": {
"enum": [
"NEW",
"AS_NEW",
"GOOD",
"REASONABLE",
"MODERATE"
],
"type": "string",
"description": "Offer condition (default NEW)."
},
"unit_price": {
"type": "number",
"maximum": 9999,
"minimum": 0,
"description": "Selling price per unit incl. VAT."
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "The products to calculate."
}
}
},
"annotations": {
"title": "Calculate commissions",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| ean * | string | EAN (8 to 14 digits). |
| page | integer | Page number, 1-200. |
| condition | string | Offer condition filter. |
| country_code | string | Webshop country (default NL). |
| best_offer_only | boolean | true = only the best offer. |
{
"name": "bol_get_competing_offers",
"title": "Competing offers for an EAN",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ean"
],
"properties": {
"ean": {
"type": "string",
"pattern": "^\\d{8,14}$",
"description": "EAN (8 to 14 digits)."
},
"page": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Page number, 1-200."
},
"condition": {
"enum": [
"ALL",
"BAD",
"MODERATE",
"REASONABLE",
"GOOD",
"AS_NEW",
"NEW",
"REFURBISHED_A",
"REFURBISHED_B",
"REFURBISHED_C"
],
"type": "string",
"description": "Offer condition filter."
},
"country_code": {
"enum": [
"NL",
"BE"
],
"type": "string",
"description": "Webshop country (default NL)."
},
"best_offer_only": {
"type": "boolean",
"description": "true = only the best offer."
}
}
},
"annotations": {
"title": "Competing offers for an EAN",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The indicator. |
| week * | integer | ISO week number, 1-53. |
| year * | integer | Year, e.g. 2026. |
{
"name": "bol_get_performance_indicator",
"title": "Get a performance indicator",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"year",
"week"
],
"properties": {
"name": {
"enum": [
"CANCELLATIONS",
"FULFILMENT",
"PHONE_AVAILABILITY",
"RESPONSE_TIME",
"CASE_ITEM_RATIO",
"TRACK_AND_TRACE",
"RETURNS",
"REVIEWS"
],
"type": "string",
"description": "The indicator."
},
"week": {
"type": "integer",
"maximum": 53,
"minimum": 1,
"description": "ISO week number, 1-53."
},
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 2000,
"description": "Year, e.g. 2026."
}
}
},
"annotations": {
"title": "Get a performance indicator",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| offer_id * | string | The offer id (UUID). |
| weeks_ahead * | integer | Weeks ahead, 1-12. |
{
"name": "bol_get_sales_forecast",
"title": "Get a sales forecast",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"offer_id",
"weeks_ahead"
],
"properties": {
"offer_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The offer id (UUID)."
},
"weeks_ahead": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Weeks ahead, 1-12."
}
}
},
"annotations": {
"title": "Get a sales forecast",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| process_status_id * | string | The process status id. |
{
"name": "bol_get_process_status",
"title": "Get a process status",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"process_status_id"
],
"properties": {
"process_status_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The process status id."
}
}
},
"annotations": {
"title": "Get a process status",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Tools for bol.com, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which open bol orders do I still have to ship?"; "Show my unhandled returns from the last weeks."; "Which of my offers are not for sale on bol, and why?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes bol.com data. Free plan: 50 tool calls per month. Run bol_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run bol_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run bol_upgrade without a plan: it returns both plans, each with a payment link for the user to open. bol_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.