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.
- Site
- bmwusa.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/bmwusaOne 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/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.
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
Name Type Required modelCodestringYes optionCodesstring[]No Returns
BmwusaBuiltVehicleinterface 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/buildVehicleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bmwusa.buildVehicle("262B");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bmwusa.buildVehicle("262B"))curl -X POST https://api.bowmark.ai/v1/sites/bmwusa/buildVehicle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"modelCode":"262B"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bmwusa.buildVehicle("262B");getModelReads one BMW model's body-style page.Arguments
Name Type Required pathstringYes Returns
BmwusaModelinterface 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/getModelCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bmwusa.getModel("x-models/x5");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bmwusa.getModel("x-models/x5"))curl -X POST https://api.bowmark.ai/v1/sites/bmwusa/getModel \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"x-models/x5"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listModelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bmwusa.listModels();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bmwusa.listModels())curl -X POST https://api.bowmark.ai/v1/sites/bmwusa/listModels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required zipstringYes Returns
BmwusaOffersResultinterface 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/listOffersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bmwusa.listOffers("48098");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bmwusa.listOffers("48098"))curl -X POST https://api.bowmark.ai/v1/sites/bmwusa/listOffers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"zip":"48098"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchCertifiedPreOwnedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bmwusa.searchCertifiedPreOwned("48098");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bmwusa.searchCertifiedPreOwned("48098"))curl -X POST https://api.bowmark.ai/v1/sites/bmwusa/searchCertifiedPreOwned \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"zip":"48098"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bmwusa.searchCertifiedPreOwned("48098");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/bmwusa/<function> - OpenAPI
/v1/sites/bmwusa/openapi.json