KOKET MCP server for AI agents
Let Claude, ChatGPT or your own agent read KOKET: 3 typed functions through one MCP server. No KOKET API key needed.
- Site
- bykoket.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just KOKET
An MCP server for KOKET 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/bykoketEvery site
One MCP server for KOKET 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
addToCartHands back the shopper's own KOKET product page.Arguments
Name Type Required idOrUrlstringYes Returns
KoketAddToCartHandoffinterface KoketAddToCartHandoff { id: string; name: string; url: string; price: number; currency: string; inStock: boolean; note: string; checkout: KoketCheckoutHandoff; } // 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 KoketCheckoutHandoff { 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/bykoket/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bykoket.addToCart("32");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bykoket.addToCart("32"))curl -X POST https://api.bowmark.ai/v1/sites/bykoket/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"32"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bykoket.addToCart("32");getProductReads one KOKET product's live page.Arguments
Name Type Required idOrUrlstringYes Returns
KoketProductinterface KoketProduct { id: string; name: string; url: string; reference: string; price: number; priceFormatted: string; listPrice: number; onSale: boolean; currency: string; inStock: boolean; quantityLeft: number | null; availabilityMessage: string; description: string; images: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bykoket/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bykoket.getProduct("32");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bykoket.getProduct("32"))curl -X POST https://api.bowmark.ai/v1/sites/bykoket/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"32"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bykoket.getProduct("32");searchProductsSearches KOKET's live public catalog (furniture, lighting, textiles) and returns each match's id, name, product URL, price and stock status.Arguments
Name Type Required querystringYes Returns
KoketProductSummary[]interface KoketProductSummary { id: string; name: string; url: string; price: number; currency: string; inStock: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bykoket/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bykoket.searchProducts("chair");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bykoket.searchProducts("chair"))curl -X POST https://api.bowmark.ai/v1/sites/bykoket/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"chair"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bykoket.searchProducts("chair");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/bykoket/<function> - OpenAPI
/v1/sites/bykoket/openapi.json