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.
- Site
- joybird.com
- 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/joybirdEvery 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/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.
Read 3
getConfiguratorReads one product's full configurator.Arguments
Name Type Required slugstringYes Returns
JoybirdCataloginterface 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/getConfiguratorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.joybird.getConfigurator("eliot-sofa");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.joybird.getConfigurator("eliot-sofa"))curl -X POST https://api.bowmark.ai/v1/sites/joybird/getConfigurator \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slug":"eliot-sofa"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listConfiguratorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.joybird.listConfigurators();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.joybird.listConfigurators())curl -X POST https://api.bowmark.ai/v1/sites/joybird/listConfigurators \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required slugstringYes selectionsRecord<string, string>Yes Returns
JoybirdPriceResultinterface 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/priceConfiguratorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.joybird.priceConfigurator("eliot-sofa", { "17": "-CF339" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.joybird.priceConfigurator("eliot-sofa", {"17": "-CF339"}))curl -X POST https://api.bowmark.ai/v1/sites/joybird/priceConfigurator \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slug":"eliot-sofa","selections":{"17":"-CF339"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.joybird.priceConfigurator("eliot-sofa", { "17": "-CF339" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/joybird/<function> - OpenAPI
/v1/sites/joybird/openapi.json