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

Just York Wallcoverings

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/yorkwallcoverings
Every site

One 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/mcp
Set it up in your client

Both 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.

Read 3
  • addToCartHands back the shopper's own York product page, with its Add to cart button, for a product search returned.

    Arguments

    NameTypeRequired
    urlOrHandlestringYes

    Returns YorkWallcoveringsAddToCartHandoff

    interface 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/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yorkwallcoverings.addToCart("<urlOrHandle>");
  • getProductReads one York product in full.

    Arguments

    NameTypeRequired
    urlOrHandlestringYes

    Returns YorkWallcoveringsProduct

    interface 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/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yorkwallcoverings.getProduct("<urlOrHandle>");

Use it from code