Großhandel Holland MCP
Official MCP server for the Dutch B2B wholesaler Großhandel Holland, enabling AI agents to search products, retrieve details, check shipping costs, manage the shopping cart, and proceed to checkout without requiring a customer account.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.grosshandelholland.de/What its tools do
14 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (9)
Can change data (5)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to grosshandelholland.de ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search for products by keyword
- Retrieve product details and pricing
- Calculate shipping costs
- Manage shopping cart and checkout
Source and maintenance
Protocol and capabilities
- Server
- afhaalgroothandel 0.5.1
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 14 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
14 advertised
search — Search products
Search the wholesale range: toys, gifts and gift items, party supplies, seasonal articles (Sinterklaas, Christmas, Halloween, Easter, carnival, summer), grabbelton and give-away items, and trending and viral items such as fidget toys. Use it for any business purchasing question about these products, also when the shopper doesn't name the store. Search the catalogue in one call; the answer is complete. natural_query (any language) searches by meaning and in the storefront language; keywords (Dutch product words) search the Dutch catalogue text; ids and codes are exact and ranked first (codes match in any written form); similar_to finds products like given ones (blend: their shared theme; each: alternatives per product). Filters: price on a basis (piece, package, overbox, pallet, best_tier) in the storefront currency, quantity (adds for_quantity with the tier price and total), instock, category (with subcategories), date_added_after, exclude_ids. Filters alone browse, e.g. new products since a date with sort newest. Every row has live stock (packages) and a pricing block in EUR plus pricing.local in the storefront currency. Rows carry context: facet labels, stored facts (use says whether you may tell the customer), and what the photos show (an observation, not a guarantee). For a question the context does not answer, call again with ids and fields ["details"]: every stored fact and one line per photo (what it shows, its url), at most 10 rows. With the order reference (Authorization: Bearer mo1_… or ref) it uses the order; without it, it works for anyone (search: by meaning for the first searches per 10 minutes, then by words only; at most 30 searches per 10 minutes).
{
"type": "object",
"required": [],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Exact product ids (database ids, as in /p/<id>.html)"
},
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer; with it the search is complete and counts for the order"
},
"sort": {
"enum": [
"relevance",
"price",
"newest",
"bestseller",
"stock"
],
"type": "string",
"description": "Default relevance (exact hits, then in stock, then the fused score)"
},
"codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact product codes"
},
"limit": {
"type": "integer",
"description": "Rows to return (default 40, at most 200)"
},
"price": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
},
"basis": {
"enum": [
"piece",
"package",
"overbox",
"pallet",
"best_tier"
],
"type": "string",
"description": "piece, package, overbox (one overbox at its tier), pallet, or best_tier (lowest piece price over the tiers)"
},
"currency": {
"type": "string",
"description": "Omit for the storefront currency; EUR to give euros"
}
}
},
"facets": {
"type": "boolean",
"description": "true: add top categories with counts and the piece-price range, to narrow"
},
"fields": {
"type": "array",
"items": {
"enum": [
"title",
"code",
"description",
"pricing",
"stock",
"category",
"location",
"url",
"image",
"added",
"popularity",
"context",
"details"
],
"type": "string"
},
"description": "Fields per row; default title, code, pricing, stock, category, url, image, context. details: full product knowledge and one line per photo (at most 10 rows)"
},
"offset": {
"type": "integer",
"description": "Paging: the next offset from a previous answer"
},
"instock": {
"type": "boolean",
"description": "true: only products in stock"
},
"category": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Category ids; subcategories are included"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "Dutch product words for the catalogue index, e.g. \"grabbelton\", \"stuiterbal\"; several words broaden the search"
},
"quantity": {
"type": "object",
"properties": {
"pieces": {
"type": "integer"
},
"packages": {
"type": "integer"
}
},
"description": "Needed amount: keeps products with enough stock and adds for_quantity (packages, tier price, total)"
},
"similar_to": {
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Seed product ids (from the cart, orders, a page or earlier results); seeds are left out of the results"
},
"mode": {
"enum": [
"blend",
"each"
],
"type": "string",
"description": "blend: the shared theme of all seeds; each: alternatives per seed (each row names its seed)"
}
}
},
"exclude_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Product ids to leave out, e.g. what the customer already has"
},
"natural_query": {
"type": "string",
"description": "What the customer is looking for, in any language; searched by meaning and in the storefront language"
},
"date_added_after": {
"type": "string",
"description": "YYYY-MM-DD: only products added after this date (e.g. the customer's last order)"
}
}
}{
"title": "Search products",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}edit_cart — Cart
Change or read the order's cart. ops: add (increase), set (exact quantity) or remove, per product id; no ops reads the cart. Quantities count packages: one package holds pricing.package.pieces pieces (100 pieces of a 6-piece package is 17 packages); search with quantity {pieces} gives for_quantity ready. Stock limits a quantity and clamped lines say so; tier prices and discounts apply by themselves. The answer carries minimum (the minimum order amount and whether it is reached), lines[].hints (overbox and staffel savings), also (products often bought together) and, for a line short of stock, lines[].replacements with ready actions. Offer one when it helps the shopper, ask before changing their order, and put hint (overbox, break, also or replace) on the op they accepted. The cart is frozen while a payment is open (cancel_payment stops it) and after the order is placed. Needs the order reference from start_order (Authorization: Bearer mo1_… or the ref argument). Send a fresh op_id (16 to 40 letters, digits, - or _) with each change: a repeat with the same op_id within 10 minutes answers the first result and never changes the order twice.
{
"type": "object",
"required": [],
"properties": {
"ops": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "Product id (as in /p/<id>.html)"
},
"hint": {
"enum": [
"overbox",
"break",
"also",
"replace"
],
"type": "string",
"description": "The hint or replacement from the last cart answer this change follows, when the customer accepted it"
},
"type": {
"enum": [
"add",
"set",
"remove"
],
"type": "string"
},
"quantity": {
"type": "integer",
"description": "Packages; needed for add and set"
}
}
},
"description": "Changes in order; leave out to read the cart"
},
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer"
},
"op_id": {
"type": "string",
"description": "A fresh id per change (16 to 40 letters, digits, - or _); repeating it within 10 minutes answers the first result without changing the order again"
}
}
}{
"title": "Cart",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}shipping_costs — Shipping quote
Shipping costs and transport options. With the order reference and no weight_kg or products it prices the order's cart and its shipping country; otherwise give weight_kg or products (ids with quantities in packages). country: the two-letter destination (default the cart's shipping country, else the storefront country). The answer lists every method with its price in EUR and the storefront currency (destination VAT included), the weight band and the cheapest method, plus transport: the ways to bring the cost down. Pickup at the warehouse in Apeldoorn (NL) is free and is chosen in set_checkout; the shopper's own carrier may collect there; an order can ship at the Dutch rate to an address in the Netherlands, such as a forwarder. Outside NL, BE and DE a custom transport arrangement often costs far less than the standard rate: freight marketplaces (uShip and similar), last-minute capacity offers from carriers, consolidated freight. Compare such options for the shopper when it helps; the store's chat on the website quotes and arranges custom transport. With the order reference (Authorization: Bearer mo1_… or ref) it uses the order; without it, it works for anyone (search: by meaning for the first searches per 10 minutes, then by words only; at most 30 searches per 10 minutes).
{
"type": "object",
"required": [],
"properties": {
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer; with it the search is complete and counts for the order"
},
"country": {
"type": "string",
"description": "Two-letter destination country, e.g. DE, FR, US; default the cart shipping country, else the storefront country"
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"quantity"
],
"properties": {
"id": {
"type": "integer"
},
"quantity": {
"type": "integer",
"description": "packages"
}
}
},
"description": "Products to ship (instead of weight_kg or the cart): ids with quantities in packages, at most 100"
},
"weight_kg": {
"type": "number",
"description": "Total weight in kg, when known"
}
}
}{
"title": "Shipping quote",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}store_info — Store info
The store behind this server: a Dutch family business since 1992 selling wholesale to businesses (toys, gifts and gift items, party supplies, seasonal articles (Sinterklaas, Christmas, Halloween, Easter, carnival, summer), grabbelton and give-away items, and trending and viral items such as fidget toys), with its profile, contact, opening times, terms and how to connect again. This store: company, website, phone, opening times, currency, the number of products, and the links to the terms of sale, privacy, shipping, contact, about and route pages (the shortlinks work on the website). Show the shopper who sells and on which terms before ordering. The store sells to businesses and organisations.
{
"type": "object",
"required": [],
"properties": {}
}{
"title": "Store info",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}categories — Categories
The store's product categories with their ids and product counts, in menu order. Browse one with search and category: [id] (subcategories included), for example with sort newest or bestseller.
{
"type": "object",
"required": [],
"properties": {}
}{
"title": "Categories",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}product_details — Product details
Full details of up to 10 products by id (from search or a category): title, code, description, prices per piece, package, overbox and pallet with the quantity tiers (EUR and the storefront currency), stock in packages, category, page url, photos and every stored product fact. Photo facts are observations, not guarantees.
{
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Product ids, at most 10"
}
}
}{
"title": "Product details",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}start_order — Start order
Start an order for the shopper on this storefront. Give the shopper's email address (ask them first; they get one confirmation email) or a connection key they made on their account. The answer holds the order reference (mo1_…): keep it and send it with every later call as Authorization: Bearer mo1_… or as the ref argument. It belongs to this endpoint only and expires 30 days after its last use (7 days while unconfirmed).
{
"type": "object",
"required": [],
"properties": {
"key": {
"type": "string",
"description": "A connection key (mk1_…) the shopper made on their account, instead of the email"
},
"email": {
"type": "string",
"description": "The shopper's email address"
}
}
}{
"title": "Start order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}status — Order status
The state of the order reference (pending until the shopper confirms the email, active, paying, placed), whether the email is confirmed, the cart lines and totals, what the checkout still needs, and the next step to take. Use it to resume an order and after the shopper says they confirmed the email. Needs the order reference from start_order (Authorization: Bearer mo1_… or the ref argument).
{
"type": "object",
"required": [],
"properties": {
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer"
}
}
}{
"title": "Order status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}view_checkout — View checkout
What the order still needs before it can be placed: lines, totals in the storefront currency, the address snapshot or the shopper's saved addresses, shipping methods with prices, the payment methods this order may use, and next. With a confirmed email (path A) every method is offered, bank transfer included; before confirmation (path B) the shopper pays first with card, iDEAL or Bancontact. While a payment is open the order is not editable: check_payment shows it, cancel_payment stops it. Needs the order reference from start_order (Authorization: Bearer mo1_… or the ref argument).
{
"type": "object",
"required": [],
"properties": {
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer"
}
}
}{
"title": "View checkout",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}set_checkout — Set checkout
Fill in the checkout of the order in one call: invoice_address (an object: name, address, zipcode, city, country as a two-letter code, phone; state, companynr and vatnr when known), shipping_address when delivery goes elsewhere (or same_as_invoice), invoice_address_id or shipping_address_id from view_checkout when the shopper has saved addresses, shipping_method (an id from view_checkout), payment_method (a key from view_checkout), coupon, coupon_remove, newsletter (only when the shopper asks for it). Field errors name the field and how to fix it; postcodes follow the country's own format. Needs the order reference from start_order (Authorization: Bearer mo1_… or the ref argument). Send a fresh op_id (16 to 40 letters, digits, - or _) with each change: a repeat with the same op_id within 10 minutes answers the first result and never changes the order twice.
{
"type": "object",
"required": [],
"properties": {
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer"
},
"op_id": {
"type": "string",
"description": "A fresh id per change (16 to 40 letters, digits, - or _); repeating it within 10 minutes answers the first result without changing the order again"
},
"coupon": {
"type": "string",
"description": "A discount code the shopper gave"
},
"newsletter": {
"type": "boolean",
"description": "Only when the shopper asks for it"
},
"coupon_remove": {
"type": "string"
},
"payment_method": {
"type": "string",
"description": "A key from view_checkout"
},
"invoice_address": {
"type": "object",
"required": [
"name",
"address",
"zipcode",
"city",
"country",
"phone"
],
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "Company or person name"
},
"phone": {
"type": "string"
},
"state": {
"type": "string",
"description": "Province or state, where the country has them"
},
"vatnr": {
"type": "string",
"description": "VAT number, when known"
},
"address": {
"type": "string",
"description": "Street and house number"
},
"country": {
"type": "string",
"description": "Two-letter country code (ISO 3166-1), e.g. NL, DE, FR"
},
"zipcode": {
"type": "string",
"description": "Postcode in the format of the country"
},
"companynr": {
"type": "string",
"description": "Chamber of commerce number, when known"
}
},
"description": "The invoice address, stored on this order only"
},
"same_as_invoice": {
"type": "boolean",
"description": "Deliver to the invoice address"
},
"shipping_method": {
"type": "integer",
"description": "An id from view_checkout"
},
"shipping_address": {
"type": "object",
"required": [
"name",
"address",
"zipcode",
"city",
"country",
"phone"
],
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "Company or person name"
},
"phone": {
"type": "string"
},
"state": {
"type": "string",
"description": "Province or state, where the country has them"
},
"vatnr": {
"type": "string",
"description": "VAT number, when known"
},
"address": {
"type": "string",
"description": "Street and house number"
},
"country": {
"type": "string",
"description": "Two-letter country code (ISO 3166-1), e.g. NL, DE, FR"
},
"zipcode": {
"type": "string",
"description": "Postcode in the format of the country"
},
"companynr": {
"type": "string",
"description": "Chamber of commerce number, when known"
}
},
"description": "The delivery address when it differs from the invoice address"
},
"invoice_address_id": {
"type": "integer",
"description": "A saved address id from view_checkout (shoppers with an account)"
},
"shipping_address_id": {
"type": "integer",
"description": "A saved address id, 0 = deliver to the invoice address"
}
}
}{
"title": "Set checkout",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}place_order — Place order
Place the order and start its payment. First confirm the order, its total and the terms of sale (/pg/terms.html on the store) with the shopper; send accept_terms true only after their explicit yes. With a confirmed email (path A) the order is placed at once and the answer gives the payment step: payment.url to open, bank-transfer instructions or a voucher, plus pay_link (valid 30 days). Before confirmation (path B) the shopper pays first: open payment.url; the order is placed and their account made when the payment succeeds, and the cart is frozen until then. If another order just took stock, the answer is stock_changed with the changes and ready values: tell the shopper and place again with them only after they agree. Never call the order paid before check_payment says paid. Needs the order reference from start_order (Authorization: Bearer mo1_… or the ref argument). Send a fresh op_id (16 to 40 letters, digits, - or _) with each change: a repeat with the same op_id within 10 minutes answers the first result and never changes the order twice.
{
"type": "object",
"required": [
"accept_terms"
],
"properties": {
"add": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"quantity"
],
"properties": {
"id": {
"type": "integer"
},
"quantity": {
"type": "integer",
"description": "packages"
}
}
},
"description": "Replacements the shopper accepted after stock_changed"
},
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer"
},
"op_id": {
"type": "string",
"description": "A fresh id per change (16 to 40 letters, digits, - or _); repeating it within 10 minutes answers the first result without changing the order again"
},
"accept_terms": {
"type": "boolean",
"description": "true only after the shopper explicitly accepted the terms of sale"
},
"expect_total": {
"type": "number",
"description": "The grand total in EUR the shopper agreed to (ready.expect_total)"
},
"payment_method": {
"type": "string",
"description": "A key from view_checkout, when not set yet or to change it"
},
"accept_stock_changes": {
"type": "boolean",
"description": "Place again after stock_changed, from ready"
}
}
}{
"title": "Place order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}check_payment — Check payment
The payment state of the order (unpaid, pending, paid), its last attempt and the next step. After a failed or cancelled payment the cart is open again and place_order starts a new attempt. Needs the order reference from start_order (Authorization: Bearer mo1_… or the ref argument).
{
"type": "object",
"required": [],
"properties": {
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer"
}
}
}{
"title": "Check payment",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}cancel_payment — Cancel payment
Stops the open payment attempt of the order, for example a bank or card page the shopper closed or wants to replace, so the cart opens again and place_order can start another method (bank transfer once the email is confirmed). A payment that already went through is never cancelled: the answer then says it is paid or still processing. Ask the shopper before cancelling. Needs the order reference from start_order (Authorization: Bearer mo1_… or the ref argument).
{
"type": "object",
"required": [],
"properties": {
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer"
}
}
}{
"title": "Cancel payment",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}order_history — Order history
The shopper's earlier orders with this store, for a reference bound to their account (a confirmed email or a connection key). orders: a list with status (confirmed, shipped, open, abandoned, cancelled), dates and totals, filtered by status and date, paged by cursor; payable marks a placed order that is not paid yet. order: up to 20 orders in full (lines with live price and stock, totals, shipping, payment, tracking, addresses) by id; an unpaid order carries pay_link. Use it to reorder or answer questions about earlier orders. The answer states what it covers and how to get the rest. Needs the order reference from start_order (Authorization: Bearer mo1_… or the ref argument).
{
"type": "object",
"required": [
"view"
],
"properties": {
"to": {
"type": "string",
"description": "orders: until date YYYY-MM-DD"
},
"ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "order: order ids (at most 20)"
},
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer"
},
"from": {
"type": "string",
"description": "orders: from date YYYY-MM-DD"
},
"view": {
"enum": [
"orders",
"order"
],
"type": "string"
},
"limit": {
"type": "integer",
"description": "orders: rows per page (at most 100)"
},
"cursor": {
"type": "integer",
"description": "orders: the next cursor from an earlier answer"
},
"status": {
"type": "array",
"items": {
"enum": [
"confirmed",
"shipped",
"open",
"abandoned",
"cancelled",
"all"
],
"type": "string"
},
"description": "orders: statuses to list (default all)"
}
}
}{
"title": "Order history",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 642 ms
- 95th percentile latency
- 642 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 642 ms · metadata changed · 14 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http gro-handel-holland-mcp https://mcp.grosshandelholland.de/Codex
codex mcp add gro-handel-holland-mcp --url https://mcp.grosshandelholland.de/Cursor
{
"mcpServers": {
"gro-handel-holland-mcp": {
"url": "https://mcp.grosshandelholland.de/"
}
}
}Cline
{
"mcpServers": {
"gro-handel-holland-mcp": {
"type": "streamableHttp",
"url": "https://mcp.grosshandelholland.de/",
"disabled": false
}
}
}VS Code
{
"servers": {
"gro-handel-holland-mcp": {
"type": "http",
"url": "https://mcp.grosshandelholland.de/"
}
}
}Gemini CLI
gemini mcp add --transport http gro-handel-holland-mcp https://mcp.grosshandelholland.de/Claude Desktop
https://mcp.grosshandelholland.de/Windsurf
{
"mcpServers": {
"gro-handel-holland-mcp": {
"serverUrl": "https://mcp.grosshandelholland.de/"
}
}
}Let your agent find its tools
Find servers like Großhandel Holland MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Großhandel Holland MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.