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.

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

Connect

Just Mixbook

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

One MCP server for Mixbook 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 5
  • getActivePromotionReads the real, currently-active sitewide coupon banner (description, code, terms URL).

    Arguments

    None.

    Returns MixbookPromotion

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/getPhotoBookPriceTable

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    pathstringYes

    Returns MixbookProductPrice

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/priceCustomBook

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/searchPhotoBookThemes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mixbook.searchPhotoBookThemes("wedding");

Use it from code