Joybird MCP server for AI agents

Let Claude, ChatGPT or your own agent read Joybird: 3 typed functions through one MCP server. No Joybird API key needed.

Functions
3
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Joybird

An MCP server for Joybird 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/joybird
Every site

One MCP server for Joybird 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
  • getConfiguratorReads one product's full configurator.

    Arguments

    NameTypeRequired
    slugstringYes

    Returns JoybirdCatalog

    interface JoybirdOptionValue {
      sku: string;
      value: string;
      cover: string | null;
      color: string | null;
      family: string;
      tier: number;
      petFriendly: boolean;
      performanceFabric: boolean;
      sustainableFabric: boolean;
      popular: boolean;
    }
    
    interface JoybirdOption {
      id: number;
      name: string;
      type: string | null;
      values: JoybirdOptionValue[];
    }
    
    interface JoybirdCatalog {
      slug: string;
      name: string;
      sku: string;
      type: string;
      family: string;
      url: string;
      dimensions: string;
      finalPrice: number;
      originalPrice: number;
      discountPercent: number;
      promotionStart: string | null;
      promotionEnd: string | null;
      options: JoybirdOption[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/joybird/getConfigurator

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.joybird.getConfigurator("eliot-sofa");
  • listConfiguratorsLists every configurable product Joybird currently sells.

    Arguments

    None.

    Returns JoybirdConfigurator[]

    interface JoybirdConfigurator {
      slug: string;
      name: string;
      sku: string;
      type: string;
      family: string;
      url: string;
      finalPrice: number;
      originalPrice: number;
      discountPercent: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/joybird/listConfigurators

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.joybird.listConfigurators();
  • priceConfiguratorPrices an exact configuration for one product given the caller's swatch picks (one swatch SKU per slot id; any slot left out uses its first available…

    Arguments

    NameTypeRequired
    slugstringYes
    selectionsRecord<string, string>Yes

    Returns JoybirdPriceResult

    interface JoybirdPriceLine {
      optionId: number;
      optionName: string;
      optionSku: string;
      valueSku: string;
      valueName: string;
    }
    
    interface JoybirdPriceResult {
      slug: string;
      sku: string;
      finalPrice: number;
      originalPrice: number;
      discountPercent: number;
      lines: JoybirdPriceLine[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/joybird/priceConfigurator

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.joybird.priceConfigurator("eliot-sofa", { "17": "-CF339" });

Use it from code