Vintagebulk MCP server
The Vintagebulk MCP server lets AI agents search the Vintagebulk wholesale catalog, build carts and prepare checkouts using the Universal Commerce Protocol (UCP) over the Model Context Protocol (MCP).
Endpoint
-
URL:
https://vintagebulk.nl/api/ucp/mcp -
Transport: MCP Streamable HTTP, JSON-RPC 2.0 (
POST,Content-Type: application/json) - Discovery: /.well-known/ucp lists supported UCP versions, capabilities and payment handlers.
- Auth: catalog and cart tools work without a token; buyer-linked checkout and orders use Shopify Customer Account OAuth (see the Vintagebulk API docs).
Tools
search_catalog, lookup_catalog, get_product, create_cart, get_cart, update_cart, cancel_cart, create_checkout, get_checkout, update_checkout, complete_checkout, cancel_checkout, get_order. Call tools/list for the current list and JSON schemas.
Example
curl -sS https://vintagebulk.nl/api/ucp/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_catalog","arguments":{"catalog":{"query":"ralph lauren polo box"}}}}'
Client configuration
{
"mcpServers": {
"vintagebulk": { "type": "http", "url": "https://vintagebulk.nl/api/ucp/mcp" }
}
}
Rules for agents
- Never call
complete_checkoutwithout explicit, contemporaneous buyer approval. - The endpoint is rate-limited per IP: back off on HTTP 429.
- Errors are JSON-RPC error objects with numeric
codeandmessage.
See also: /agents.md, OpenAPI spec, Vintagebulk API.