MCP · Claude · Bol.com
Claude.ai · Desktop · Claude Code
Bol.com in Claude: the hosted Bol MCP connector
To connect Bol.com to Claude, add Marktspan's hosted MCP server (https://marktspan.com/api/mcp) as a custom connector in Claude and sign in with Marktspan. Claude can then analyze your Bol shop — orders, contribution after commission and LVB fees, Sponsored Products, keyword demand, and invoice lines — using the same numbers as your P&L.
Claude custom connector URL
https://marktspan.com/api/mcp
Add the Bol.com connector to Claude
The same URL works in Claude.ai, Claude Desktop, and Claude Code. Connect your Bol shop in Marktspan first and turn MCP on under Settings → MCP.
- Claude.ai and Desktop: Settings → Connectors → Add custom connector → name it Marktspan → paste https://marktspan.com/api/mcp → Connect, then sign in with Marktspan.
- Team and Enterprise: an owner adds the connector once under organization settings; each member signs in with their own Marktspan account and role.
- Claude Code: run `claude mcp add --transport http marktspan https://marktspan.com/api/mcp`, then `/mcp` to authenticate.
- Start a new chat and ask “Which Bol shops can you see?” to confirm the connection.
What Claude does well with Bol data
Claude is strong at long, multi-step analysis. Give it a question and it chains the tools: list the shops, pull contribution, drill into EANs, check ads, then write the summary.
- Explain a contribution drop on Bol NL: which EANs, which cost line, and whether stock or ads changed.
- Write a weekly Bol report for the team from live numbers instead of a pasted export.
- Compare Bol NL and BE side by side without mixing their data.
- Reconcile Bol invoice charges per order and EAN (finance role).
Hosted connector vs. a local Bol MCP server
Community Bol MCP servers run on your machine with your Retailer API client ID and secret and return raw API responses. Marktspan's connector is hosted, signs in with OAuth, keeps Bol credentials in your workspace, and answers from cleaned EUR data that already joins orders, fees, ads, and invoices.
Read-only by default
Claude can read and analyze, not change your Bol listings, prices, or bids. Bid changes go through Ad Pilot approval or governed write tools on eligible plans, always with a dry run first.
Tools Claude uses for Bol.com
A selection. Claude picks the tool from your question. Ads tools need the Growth plan; finance lines need a finance or admin role in the workspace.
| Tool | Plan | What you get | Try asking Claude… |
|---|---|---|---|
| whoami | Start+ | Your workspace and the Bol.com NL and BE shops the assistant can see. | Which Bol shops can you see? |
| query_metric | Start+ | Revenue, orders, units, and contribution per day, EAN, or shop. | Top 10 EANs by contribution on Bol NL last month. |
| get_search_terms | Growth+ | Sponsored Products search terms with clicks, cost, conversions, and ACoS. | Which search terms spent money without orders this week? |
| search_keyword_demand | Start+ | Bol.com search volume, trend, and average winning bid. | How big is demand for 'luchtbevochtiger' and when does it peak? |
| query_viz · bol_finance_report_lines | Start+ · finance role | Bol invoice lines: commission, fulfillment, shipping, and returns per order and EAN. | What did Bol charge in commission on EAN 8712345678906 in September? |
Bol.com workflows in Claude
Root-cause a bad week
“Contribution on Bol NL fell 18% last week. Find the EANs responsible, check stock and ad spend for each, and summarize in five bullets.”
Category entry memo
Ask Claude to rank Bol leaf categories by demand, pull bestsellers and winning bids for the top two, and estimate unit economics at your target price.
Invoice reconciliation
Ask Claude to list Bol commission and fulfillment charges per order for a product in a month and flag lines that look off against the commission rate.
FAQ
- Is there an official Bol.com connector for Claude?
- No. bol.com does not publish a Claude connector or MCP server. Marktspan hosts a Bol MCP server you add to Claude as a custom connector.
- How do I connect Bol.com to Claude?
- Connect your Bol shop in Marktspan, then in Claude open Settings → Connectors → Add custom connector, paste https://marktspan.com/api/mcp, and sign in with Marktspan.
- Does it work in Claude Code and Claude Desktop?
- Yes. Claude Desktop uses the same connector settings as Claude.ai. In Claude Code, add the URL with `claude mcp add --transport http`.
- Can Claude read Bol invoices and commission?
- Yes, for users with a finance or admin role: Bol invoice lines per order and EAN with commission, fulfillment, shipping, and returns charges.
- Does Claude get my Bol API keys?
- No. Claude signs in with Marktspan over OAuth. The Bol connection and its credentials stay in your workspace.
- Does the same server work in ChatGPT?
- Yes. See the Bol.com ChatGPT page for the ChatGPT app steps.
Put your Bol.com shop in Claude
We can add the connector on your workspace in a short call.