CultureFly MCP server for AI agents
Let Claude, ChatGPT or your own agent read CultureFly: 3 typed functions through one MCP server. No CultureFly API key needed.
- Site
- culturefly.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for CultureFly 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/cultureflyOne MCP server for CultureFly 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.
buildCultureFlyCheckoutLinkResolves a chosen size + cadence against getCultureFlyBoxOptions and returns the exact checkout handoff URL CultureFly's own storefront builds for…Arguments
Name Type Required handlestringYes sizestringYes cadencestringYes Returns
CultureFlyCheckoutLinkinterface CultureFlyCheckoutLink { handle: string; size: string; cadence: string; /** The exact per-size, per-cadence price the storefront is quoting. */ price: string; /** GET this URL to land straight on CultureFly's own checkout with the chosen size + cadence pre-selected. */ checkoutUrl: string; checkout: CultureFlyCheckoutHandoff; } // 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 CultureFlyCheckoutHandoff { 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/culturefly/buildCultureFlyCheckoutLinkCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.culturefly.buildCultureFlyCheckoutLink("star-wars-collectors-box", "M", "Quarterly");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.culturefly.buildCultureFlyCheckoutLink("star-wars-collectors-box", "M", "Quarterly"))curl -X POST https://api.bowmark.ai/v1/sites/culturefly/buildCultureFlyCheckoutLink \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"star-wars-collectors-box","size":"M","cadence":"Quarterly"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.culturefly.buildCultureFlyCheckoutLink("star-wars-collectors-box", "M", "Quarterly");getCultureFlyBoxOptionsReads one box's full configure surface off its own product page.Arguments
Name Type Required handlestringYes Returns
CultureFlyBoxOptionsinterface CultureFlySize { /** The apparel size label the widget renders (e.g. "S", "XL", "3XL"). */ size: string; /** The Shopify variant id this size resolves to FOR THIS CADENCE. */ variantId: string; /** Dollar-and-cents string for this size at this cadence, e.g. "120.00". */ price: string; } interface CultureFlyCadence { /** "One-Time" | "Quarterly" | "Annual", CultureFly's own widget labels. */ cadence: string; /** The Shopify product id backing this cadence (a distinct product per cadence). */ productId: string; /** Null for the one-time (non-subscription) cadence. */ sellingPlanId: string | null; sizes: CultureFlySize[]; } interface CultureFlyBoxOptions { title: string; cadences: CultureFlyCadence[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/culturefly/getCultureFlyBoxOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.culturefly.getCultureFlyBoxOptions("star-wars-collectors-box");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.culturefly.getCultureFlyBoxOptions("star-wars-collectors-box"))curl -X POST https://api.bowmark.ai/v1/sites/culturefly/getCultureFlyBoxOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"star-wars-collectors-box"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.culturefly.getCultureFlyBoxOptions("star-wars-collectors-box");listCultureFlyBoxesReads the live CultureFly catalogue for exactly the licensed subscription-box product LINES (Star Wars, Pusheen, Friends, Supernatural, and any…Arguments
None.
Returns
CultureFlyBoxSummary[]interface CultureFlyBoxSummary { handle: string; title: string; vendor: string; /** CultureFly's own tags, verbatim, includes "Collector Box" (the filter). */ tags: string[]; /** The storefront's own hero image, or null when the product has none. */ image: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/culturefly/listCultureFlyBoxesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.culturefly.listCultureFlyBoxes();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.culturefly.listCultureFlyBoxes())curl -X POST https://api.bowmark.ai/v1/sites/culturefly/listCultureFlyBoxes \ -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.culturefly.listCultureFlyBoxes();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/culturefly/<function> - OpenAPI
/v1/sites/culturefly/openapi.json