BMW USA MCP server for AI agents

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

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

Connect

Just BMW USA

An MCP server for BMW USA 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/bmwusa
Every site

One MCP server for BMW USA 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 5
  • buildVehicleRuns BMW's own Build Your Own configurator for a model code (read off /all-bmws.html's build-your-own.html#/studio/{code} links, or getModel's own…

    Arguments

    NameTypeRequired
    modelCodestringYes
    optionCodesstring[]No

    Returns BmwusaBuiltVehicle

    interface BmwusaBuiltVehicleOption {
      code: string;
      name: string;
      price: number;
    }
    
    interface BmwusaBuiltVehicle {
      modelCode: string;
      modelName: string;  // searchCertifiedPreOwned's options.model takes this verbatim ("X5 40 xDrive" keeps the X5 rows)
      series: string;  // searchCertifiedPreOwned's options.model takes this verbatim too ("2 Series", "X5")
      bodyStyle: string;
      year: number;
      basePrice: number;
      destinationAndHandling: number;
      selectedOptions: BmwusaBuiltVehicleOption[];
      totalPrice: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bmwusa/buildVehicle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bmwusa.buildVehicle("262B");
  • getModelReads one BMW model's body-style page.

    Arguments

    NameTypeRequired
    pathstringYes

    Returns BmwusaModel

    interface BmwusaModelTrim {
      name: string;
      modelCode: string | null;
      zeroToSixty: number | null;
      horsepower: number | null;
      startingMsrp: number | null;
      buildable: boolean;
      engineType: string | null;
      drivetrain: string | null;
      transmission: string | null;
      fuelType: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      fuelEfficiency: { city: number | null; highway: number | null; combined: number | null; unit: string } | null;
      seatingCapacity: number | null;
    }
    
    interface BmwusaModel {
      name: string;
      series: string;
      url: string;
      trims: BmwusaModelTrim[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bmwusa/getModel

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bmwusa.getModel("x-models/x5");
  • listModelsLists BMW's current US lineup.

    Arguments

    None.

    Returns BmwusaModelListing[]

    interface BmwusaModelListing {
      name: string;
      url: string;
      bodyStyle: string | null;
      powertrain: "electric" | "plugInHybrid" | "performance" | "gasoline" | null;
      msrpFrom: number | null;
      msrpTo: number | null;
      trimCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bmwusa/listModels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bmwusa.listModels();
  • listOffersLists BMW's current US lease and finance offers for a ZIP code (resolved server-side to a sales region).

    Arguments

    NameTypeRequired
    zipstringYes

    Returns BmwusaOffersResult

    interface BmwusaOfferTier {
      apr: number;
      months: number;
    }
    
    interface BmwusaLeaseOffer {
      code: string;
      description: string;
      monthlyPayment: number;
      term: number;
      msrp: number;
      downPayment: number;
      acquisitionFee: number;
      dueAtSigningExceptNy: number | null;
      loyaltyCredit: number | null;
      dealerContribution: string | null;
      allowedMiles: number | null;
      chargePerExcessMile: number | null;
      endOfTermPurchaseOption: number | null;
      startDate: string;
      endDate: string;
    }
    
    interface BmwusaFinanceOffer {
      code: string;
      description: string;
      tiers: BmwusaOfferTier[];
      loyaltyCredit: number | null;
      startDate: string;
      endDate: string;
    }
    
    interface BmwusaOffer {
      modelCode: string;  // buildVehicle takes this
      modelName: string;  // searchCertifiedPreOwned's options.model takes this verbatim
      series: string;  // searchCertifiedPreOwned's options.model takes this verbatim too
      bodyStyle: string;
      msrp: number;
      lease: BmwusaLeaseOffer | null;
      finance: BmwusaFinanceOffer | null;
    }
    
    interface BmwusaOffersResult {
      region: string;
      offers: BmwusaOffer[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bmwusa/listOffers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bmwusa.listOffers("48098");
  • searchCertifiedPreOwnedSearches BMW's live Certified Pre-Owned inventory near a ZIP code, server-side scoped to CPO-only stock, returning each match's VIN, year, model…

    Arguments

    NameTypeRequired
    zipstringYes
    options{ radius?: number; limit?: number; model?: string; minYear?: number; maxYear?: number; maxPrice?: number; maxOdometer?: number }No

    Returns BmwusaCpoVehicle[]

    interface BmwusaCpoDealer {
      name: string;
      url: string;
      city: string;
      state: string;
      postalCode: string;
      distance: number;
    }
    
    interface BmwusaCpoVehicle {
      vin: string;
      year: number;
      model: string;
      trim: string;
      bodyStyle: string;
      exteriorColor: string;
      interiorColor: string;
      odometer: number;
      price: number;
      drivetrain: string;
      fuelType: string;  // the site's own labels, read the values off a result, never guess one from prose
      vdpUrl: string;
      photos: string[];
      dealer: BmwusaCpoDealer;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bmwusa/searchCertifiedPreOwned

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bmwusa.searchCertifiedPreOwned("48098");

Use it from code