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.

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/bykoket
Every 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/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
  • addToCartHands back the shopper's own KOKET product page.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns KoketAddToCartHandoff

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bykoket.addToCart("32");
  • getProductReads one KOKET product's live page.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns KoketProduct

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

    Call it

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

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bykoket.searchProducts("chair");

Use it from code