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_checkout without explicit, contemporaneous buyer approval.
  • The endpoint is rate-limited per IP: back off on HTTP 429.
  • Errors are JSON-RPC error objects with numeric code and message.

See also: /agents.md, OpenAPI spec, Vintagebulk API.