Connect your bol seller account at https://bol-com.usefulapi.io/mcp.
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://bol-com.usefulapi.io/mcp.
- Claude Code:
claude mcp add --transport http bol-com https://bol-com.usefulapi.io/mcp, then run /mcp to log in.
- VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"bol-com": {
"url": "https://bol-com.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your bol.com credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bol-com/
Create a dedicated client ID and secret for UsefulAPI in your bol Seller Dashboard. This uses bol’s documented authentication route for unlisted integration providers. UsefulAPI is independent and is not a listed bol integration partner. Revoke these credentials in bol to stop access. Buyer information you request passes to your chosen AI client and its LLM provider. Creating a new client ID starts a new usage and billing identity.
| Tool | Type | What it does |
|---|
bol_list_orders | read | List orders |
bol_get_order | read | Get an order |
bol_list_shipments | read | List shipments |
bol_get_shipment | read | Get a shipment |
bol_list_returns | read | List returns |
bol_get_return | read | Get a return |
bol_list_offers | read | List offers |
bol_get_offer | read | Get an offer |
bol_get_offer_not_for_sale_reasons | read | Why an offer is not for sale |
bol_update_offer | write | Update an offer |
bol_list_inventory | read | List FBB inventory |
bol_list_invoices | read | List invoices |
bol_get_invoice_specification | read | Get an invoice specification |
bol_get_commissions | read | Calculate commissions |
bol_get_competing_offers | read | Competing offers for an EAN |
bol_get_performance_indicator | read | Get a performance indicator |
bol_get_sales_forecast | read | Get a sales forecast |
bol_get_process_status | read | Get a process status |
bol_usage_status | meta | Usage status (free-tier meter) |
bol_request_feature | meta | Request a missing feature |
bol_upgrade | meta | Upgrade to Pro or Pro+ |
bol_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|
| Free | $0 | 50 tool calls / month |
| Pro (per API client ID) | $9/mo or $90/yr (2 months free) | 10,000 tool calls / month |
| Pro+ (per API client ID) | $39/mo or $390/yr (2 months free) | 100,000 tool calls / month |
Each paid plan covers this server only. Ask your AI to run bol_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with bol_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with bol_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
License
Independent integration by usefulapi. See Terms and Privacy.