Mixbook MCP server for AI agents
Let Claude, ChatGPT or your own agent read Mixbook: 5 typed functions through one MCP server. No Mixbook API key needed.
- Site
- mixbook.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Mixbook 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/mixbookOne MCP server for Mixbook 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.
getActivePromotionReads the real, currently-active sitewide coupon banner (description, code, terms URL).Arguments
None.
Returns
MixbookPromotioninterface MixbookPromotion { description: string; // e.g. "Up to 50% off + an extra 10% off & free shipping on 79+" code: string; termsUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/mixbook/getActivePromotionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.mixbook.getActivePromotion();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.mixbook.getActivePromotion())curl -X POST https://api.bowmark.ai/v1/sites/mixbook/getActivePromotion \ -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.mixbook.getActivePromotion();getPhotoBookPriceTableReturns Mixbook's full published rate card: every cover/paper x size combination, the real base price for a 20-page book, and the real…Arguments
Name Type Required bindingMixbookBindingNo // Mixbook's OWN shapes, not a capability contract. type MixbookBinding = "softcover" | "hardcover";Returns
MixbookPriceCell[]// Mixbook's OWN shapes, not a capability contract. type MixbookBinding = "softcover" | "hardcover"; interface MixbookPriceCell { binding: MixbookBinding; cover: string; paper: string; size: string; basePrice20pg: number; // dollars, real published base price for a 20-page book perAdditionalPage: number; // dollars, real published per-page increment currency: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/mixbook/getPhotoBookPriceTableCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.mixbook.getPhotoBookPriceTable();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.mixbook.getPhotoBookPriceTable())curl -X POST https://api.bowmark.ai/v1/sites/mixbook/getPhotoBookPriceTable \ -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.mixbook.getPhotoBookPriceTable();getProductPriceReads one theme's real product page and returns Mixbook's own server-computed price for its default size/cover/paper/page-count configuration.Arguments
Name Type Required pathstringYes Returns
MixbookProductPriceinterface MixbookProductPrice { path: string; name: string; sku: string; size: string; price: number; // real Mixbook-computed price for the default configuration currency: string; availability: string; // the site's own labels, read the values off a result, never guess one from prose url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/mixbook/getProductPriceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.mixbook.getProductPrice("/all-photo-books/blank-canvas-10");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.mixbook.getProductPrice("/all-photo-books/blank-canvas-10"))curl -X POST https://api.bowmark.ai/v1/sites/mixbook/getProductPrice \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"/all-photo-books/blank-canvas-10"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.mixbook.getProductPrice("/all-photo-books/blank-canvas-10");priceCustomBookPrices an exact custom photo book (binding, cover, paper, size, page count) against Mixbook's own published rate-card formula.Arguments
Name Type Required bindingMixbookBindingYes coverstringYes paperstringYes sizestringYes pageCountnumberYes // Mixbook's OWN shapes, not a capability contract. type MixbookBinding = "softcover" | "hardcover";Returns
MixbookCustomBookPrice// Mixbook's OWN shapes, not a capability contract. type MixbookBinding = "softcover" | "hardcover"; interface MixbookPriceCell { binding: MixbookBinding; cover: string; paper: string; size: string; basePrice20pg: number; // dollars, real published base price for a 20-page book perAdditionalPage: number; // dollars, real published per-page increment currency: string; } interface MixbookCustomBookPrice { binding: MixbookBinding; cover: string; paper: string; size: string; pageCount: number; totalPrice: number; // basePrice20pg + perAdditionalPage * max(0, pageCount - 20) currency: string; cell: MixbookPriceCell; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/mixbook/priceCustomBookCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.mixbook.priceCustomBook("hardcover", "Matte", "Everyday Semi-Gloss", "8.5×8.5", 40);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.mixbook.priceCustomBook("hardcover", "Matte", "Everyday Semi-Gloss", "8.5×8.5", 40))curl -X POST https://api.bowmark.ai/v1/sites/mixbook/priceCustomBook \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"binding":"hardcover","cover":"Matte","paper":"Everyday Semi-Gloss","size":"8.5×8.5","pageCount":40}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.mixbook.priceCustomBook("hardcover", "Matte", "Everyday Semi-Gloss", "8.5×8.5", 40);searchPhotoBookThemesSearches Mixbook's real 750+ photo-book theme catalog (Mixbook's own public Algolia index) and returns real theme names, descriptions, page counts…Arguments
Name Type Required querystringYes Returns
MixbookThemeResult[]interface MixbookThemeResult { name: string; description: string; path: string; // pass into getProductPrice themeId: number; pageCount: number; orientation: string; image: string; tags: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/mixbook/searchPhotoBookThemesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.mixbook.searchPhotoBookThemes("wedding");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.mixbook.searchPhotoBookThemes("wedding"))curl -X POST https://api.bowmark.ai/v1/sites/mixbook/searchPhotoBookThemes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"wedding"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.mixbook.searchPhotoBookThemes("wedding");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/mixbook/<function> - OpenAPI
/v1/sites/mixbook/openapi.json