KOMPAN Master MCP server for AI agents

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

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

Connect

Just KOMPAN Master

An MCP server for KOMPAN Master 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/kompan
Every site

One MCP server for KOMPAN Master 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
  • getSparePartsDocumentsReads the real spare-parts / TÜV-certificate / maintenance-manual documents KOMPAN Master publishes for one variant + purchase date.

    Arguments

    NameTypeRequired
    variantIdstringYes
    purchaseDatestringYes

    Returns KompanSparePartsDocuments

    interface KompanDocument {
      section: string;      // the site's own heading, e.g. "Layout Drawing", "Installation Instruction"
      label: string;
      url: string;
    }
    
    interface KompanSparePartsDocuments {
      variantId: string;
      purchaseDate: string;
      title: string | null;
      documents: KompanDocument[];
      fullPackageUrl: string | null;   // generated on fetch by the site, the URL to fetch, not a static file
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/kompan/getSparePartsDocuments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.kompan.getSparePartsDocuments("117", "2020-06-15");
  • searchPlaygroundSparePartsSingle-object-argument search keyed by product_no that reports whether a playground product has spare parts listed.

    Arguments

    NameTypeRequired
    args{ product_no: string; region?: KompanRegion }Yes
    // KOMPAN Master's OWN shapes, not a capability contract.
    type KompanRegion = "region_america" | "region_europe_middleeast" | "region_asia_newzealand" | "region_australia";

    Returns KompanSearchResult

    // KOMPAN Master's OWN shapes, not a capability contract.
    type KompanRegion = "region_america" | "region_europe_middleeast" | "region_asia_newzealand" | "region_australia";
    
    interface KompanVariant {
      id: string;         // pass to getSparePartsDocuments()
      title: string;       // e.g. "PCM157-0205 | UNIVERSAL CAROUSEL"
    }
    
    interface KompanSearchResult {
      productNo: string;
      region: KompanRegion;
      found: boolean;       // false is a real "no such product number in this region" answer
      image: string | null;
      variants: KompanVariant[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/kompan/searchPlaygroundSpareParts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.kompan.searchPlaygroundSpareParts({ product_no: "PCM157" });
  • searchProductSearches KOMPAN Master for a product number in one region and lists every real installed variant, each with the item id getSparePartsDocuments()…

    Arguments

    NameTypeRequired
    productNostringYes
    regionKompanRegionNo
    // KOMPAN Master's OWN shapes, not a capability contract.
    type KompanRegion = "region_america" | "region_europe_middleeast" | "region_asia_newzealand" | "region_australia";

    Returns KompanSearchResult

    // KOMPAN Master's OWN shapes, not a capability contract.
    type KompanRegion = "region_america" | "region_europe_middleeast" | "region_asia_newzealand" | "region_australia";
    
    interface KompanVariant {
      id: string;         // pass to getSparePartsDocuments()
      title: string;       // e.g. "PCM157-0205 | UNIVERSAL CAROUSEL"
    }
    
    interface KompanSearchResult {
      productNo: string;
      region: KompanRegion;
      found: boolean;       // false is a real "no such product number in this region" answer
      image: string | null;
      variants: KompanVariant[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/kompan/searchProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.kompan.searchProduct("PCM157", "region_america");

Use it from code