York Wallcoverings MCP server for AI agents
Let Claude, ChatGPT or your own agent read York Wallcoverings: 3 typed functions through one MCP server. No York Wallcoverings API key needed.
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for York Wallcoverings alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/yorkwallcoveringsOne MCP server for York Wallcoverings and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
addToCartHands back the shopper's own York product page, with its Add to cart button, for a product search returned.Arguments
Name Type Required urlOrHandlestringYes Returns
YorkWallcoveringsAddToCartHandoffinterface YorkWallcoveringsAddToCartHandoff { sku: string; name: string; url: string; price: number; inStock: boolean; note: string; checkout: YorkWallcoveringsCheckoutHandoff; // a cart link carrying the default full-size variant, quantity 1; Bowmark never pays } // The checkout handoff: where the PERSON finishes. Bowmark never pays, books or orders. // Switch on `status`; a status you do not recognise means "show the person `url` and stop". interface YorkWallcoveringsCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; // the https page to open on the site urlKind?: "carries_items" | "signed_in_cart" | "product_page"; // ready_to_checkout only: does the link carry the items, or only open the item's page reason?: string; // unavailable only: out_of_stock | not_available_for_dates | not_sold_online | region_not_served | quantity_unavailable | empty_cart detail?: string; // unavailable only: one sentence saying why account: { site: string; hint: string; signedInAs?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string } | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yorkwallcoverings/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yorkwallcoverings.addToCart("<urlOrHandle>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yorkwallcoverings.addToCart("<urlOrHandle>"))curl -X POST https://api.bowmark.ai/v1/sites/yorkwallcoverings/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlOrHandle":"<urlOrHandle>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yorkwallcoverings.addToCart("<urlOrHandle>");getProductReads one York product in full.Arguments
Name Type Required urlOrHandlestringYes Returns
YorkWallcoveringsProductinterface YorkWallcoveringsVariant { variantId: string; // Shopify's numeric variant id, what a cart link carries sku: string | null; title: string; // e.g. "Periwinkle / Double Roll (27in x 27.0ft)" price: number; available: boolean; isSample: boolean; // the 8in x 10in swatch sold beside every colourway } interface YorkWallcoveringsProduct { handle: string; sku: string; name: string; url: string; price: number; inStock: boolean; description: string; images: string[]; variantId: string; // the variant the headline sku and price describe currency?: string; variants: YorkWallcoveringsVariant[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yorkwallcoverings/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yorkwallcoverings.getProduct("<urlOrHandle>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yorkwallcoverings.getProduct("<urlOrHandle>"))curl -X POST https://api.bowmark.ai/v1/sites/yorkwallcoverings/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlOrHandle":"<urlOrHandle>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yorkwallcoverings.getProduct("<urlOrHandle>");searchSearches York's live public catalog (wallpaper, wall murals, grasscloth) by keyword through the store's own search and returns each match's handle…Arguments
Name Type Required querystringYes Returns
YorkWallcoveringsSearchResult[]interface YorkWallcoveringsSearchResult { handle: string; // pass into getProduct sku: string; // the first purchasable full-size variant, never the sample name: string; url: string; price: number; inStock: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/yorkwallcoverings/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.yorkwallcoverings.search("floral");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.yorkwallcoverings.search("floral"))curl -X POST https://api.bowmark.ai/v1/sites/yorkwallcoverings/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"floral"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.yorkwallcoverings.search("floral");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/yorkwallcoverings/<function> - OpenAPI
/v1/sites/yorkwallcoverings/openapi.json