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.
- Site
- semihandmade.com
- 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/semihandmadeEvery 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/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
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
Name Type Required handlestringYes Returns
SemihandmadePartOptionsinterface 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/getPartOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.semihandmade.getPartOptions("white-supermatte-slab-door-for-sektion-grouped");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.semihandmade.getPartOptions("white-supermatte-slab-door-for-sektion-grouped"))curl -X POST https://api.bowmark.ai/v1/sites/semihandmade/getPartOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"white-supermatte-slab-door-for-sektion-grouped"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required handlestringYes selectionsRecord<string, string>Yes Returns
SemihandmadePriceResultinterface 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/priceConfigurationCall 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" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.semihandmade.priceConfiguration("white-supermatte-slab-door-for-sektion-grouped", {"Width": "15\"", "Height": "15\"", "Color": "White"}))curl -X POST https://api.bowmark.ai/v1/sites/semihandmade/priceConfiguration \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"white-supermatte-slab-door-for-sektion-grouped","selections":{"Width":"15\"","Height":"15\"","Color":"White"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchPartsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.semihandmade.searchParts("sektion", "door");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.semihandmade.searchParts("sektion", "door"))curl -X POST https://api.bowmark.ai/v1/sites/semihandmade/searchParts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"system":"sektion","query":"door"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.semihandmade.searchParts("sektion", "door");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/semihandmade/<function> - OpenAPI
/v1/sites/semihandmade/openapi.json