Semihandmade MCP server for AI agents

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

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

Connect

Just Semihandmade

An MCP server for Semihandmade 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/semihandmade
Every site

One MCP server for Semihandmade 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
  • getPartOptionsReads one part's real live size grid: every real size combination with its own real price and availability, keyed by that part's own option names…

    Arguments

    NameTypeRequired
    handlestringYes

    Returns SemihandmadePartOptions

    interface SemihandmadeSizeOption {
      options: Record<string, string>;  // this part's OWN option names -> this size's values
      price: number;                    // this exact size's own real price
      available: boolean;
      sku: string;
      variantId: string;
    }
    
    interface SemihandmadePartOptions {
      handle: string;
      title: string;
      url: string;
      optionNames: string[];   // this part's own option names, in the site's order
      sizes: SemihandmadeSizeOption[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/semihandmade/getPartOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.semihandmade.getPartOptions("white-supermatte-slab-door-for-sektion-grouped");
  • priceConfigurationResolves one exact size selection to Semihandmade's own real price, availability and SKU for that exact variant, plus the product page to finish…

    Arguments

    NameTypeRequired
    handlestringYes
    selectionsRecord<string, string>Yes

    Returns SemihandmadePriceResult

    interface SemihandmadePriceResult {
      handle: string;
      title: string;
      selections: Record<string, string>;
      price: number;           // the real price for this exact size
      available: boolean;
      sku: string;
      productUrl: string;      // finish choosing/checkout on the real product page
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/semihandmade/priceConfiguration

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.semihandmade.priceConfiguration("white-supermatte-slab-door-for-sektion-grouped", { Width: "15\"", Height: "15\"", Color: "White" });
  • searchPartsSearches Semihandmade's real catalog for one IKEA cabinet system (Sektion, Akurum, Besta/Media Units, Godmorgon/Bathroom) via the site's own Shopify…

    Arguments

    NameTypeRequired
    systemstringYes
    querystringNo

    Returns SemihandmadePart[]

    // Semihandmade's OWN shapes, not a capability contract.
    interface SemihandmadePart {
      system: string;         // "sektion" | "akurum" | "media-units" | "bathroom"
      handle: string;         // the key getPartOptions/priceConfiguration take
      title: string;
      url: string;
      material: string;       // e.g. "supermatte" | "impression" | "classic" | ""
      style: string;          // e.g. "slab" | "shaker" | "beaded" | "quarterline" | "walnut-vertical" | ""
      partType: string;
      priceMin: number;       // dollars, the cheapest real size for this part
      priceMax: number;
      variantCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/semihandmade/searchParts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.semihandmade.searchParts("sektion", "door");

Use it from code