Bellwether Coffee MCP server for AI agents
Let Claude, ChatGPT or your own agent read Bellwether Coffee: 2 typed functions through one MCP server. No Bellwether Coffee API key needed.
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Bellwether Coffee
An MCP server for Bellwether Coffee 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/bellwethercoffeeEvery site
One MCP server for Bellwether Coffee 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 2
computeRoiEstimateCalculate how much a cafe or coffee shop would save by roasting its own coffee in-house on a Bellwether roaster instead of buying it roasted (coffee…Arguments
Name Type Required currencyBellwethercoffeeCurrencyYes roasterTypeBellwethercoffeeRoasterTypeYes poundsWeeklynumberWeekly roasted-coffee usage (lb, or kg for non-USD).Yes coffeeCostnumberWhat the caller currently pays per lb/kg, in currency.Yes retailBagsnumberRetail bags of roasted coffee sellable per week.Yes Returns
BellwethercoffeeRoiEstimate// Bellwether Coffee's OWN shapes, not a capability contract. type BellwethercoffeeCurrency = "USD" | "CAD" | "GBP" | "EUR"; type BellwethercoffeeRoasterType = "ShopRoaster" | "ContinuousRoasting"; interface BellwethercoffeeRoiEstimate { currency: BellwethercoffeeCurrency; roasterType: BellwethercoffeeRoasterType; investmentAmount: number; investmentAmountFormatted: string; savingsPerUnit: number; monthlySavings: number; monthlySavingsFormatted: string; annualSavings: number; annualSavingsFormatted: string; monthlySalesRevenue: number; monthlySalesRevenueFormatted: string; annualSalesRevenue: number; annualSalesRevenueFormatted: string; annualRetailProfit: number; annualRetailProfitFormatted: string; totalROI: number; totalROIFormatted: string; // first-year ROI: annualSavings + annualRetailProfit paybackMonths: number; // 999 sentinel when there is no payback at these inputs savingsPerCup: number; co2SavingsPerYear: number; roiCalculatorUrl: string; requestDemoUrl: string; // the site's own next step, a separate lead form, not computed here }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bellwethercoffee/computeRoiEstimateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bellwethercoffee.computeRoiEstimate({ currency: "USD", roasterType: "ShopRoaster", poundsWeekly: 50, coffeeCost: 12, retailBags: 20 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bellwethercoffee.computeRoiEstimate({ "currency": "USD", "roasterType": "ShopRoaster", "poundsWeekly": 50, "coffeeCost": 12, "retailBags": 20 }))curl -X POST https://api.bowmark.ai/v1/sites/bellwethercoffee/computeRoiEstimate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{"currency":"USD","roasterType":"ShopRoaster","poundsWeekly":50,"coffeeCost":12,"retailBags":20}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bellwethercoffee.computeRoiEstimate({ currency: "USD", roasterType: "ShopRoaster", poundsWeekly: 50, coffeeCost: 12, retailBags: 20 });getCalculatorDefaultsInputs for the coffee roasting savings calculator: returns the ROI calculator's own currencies, roaster types, per-currency default input values…Arguments
None.
Returns
BellwethercoffeeCalculatorDefaults// Bellwether Coffee's OWN shapes, not a capability contract. type BellwethercoffeeCurrency = "USD" | "CAD" | "GBP" | "EUR"; type BellwethercoffeeRoasterType = "ShopRoaster" | "ContinuousRoasting"; interface BellwethercoffeeSliderBounds { min: number; max: number; step: number } interface BellwethercoffeeSliderBoundsSet { poundsWeekly: BellwethercoffeeSliderBounds; coffeeCost: BellwethercoffeeSliderBounds; retailBags: BellwethercoffeeSliderBounds } interface BellwethercoffeeCalculatorDefaults { currencies: BellwethercoffeeCurrency[]; roasterTypes: BellwethercoffeeRoasterType[]; defaultInputsByCurrency: Record<BellwethercoffeeCurrency, { poundsWeekly: number; coffeeCost: number; retailBags: number }>; sliderBounds: BellwethercoffeeSliderBoundsSet; // USD only, prefer sliderBoundsByCurrency sliderBoundsByCurrency: Record<BellwethercoffeeCurrency, BellwethercoffeeSliderBoundsSet>; // price max differs: USD 50/lb, others 100/kg roasterPricesByCurrency: Record<BellwethercoffeeCurrency, Record<BellwethercoffeeRoasterType, number>>; disclaimer: string; roiCalculatorUrl: string; requestDemoUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bellwethercoffee/getCalculatorDefaultsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bellwethercoffee.getCalculatorDefaults();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bellwethercoffee.getCalculatorDefaults())curl -X POST https://api.bowmark.ai/v1/sites/bellwethercoffee/getCalculatorDefaults \ -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.bellwethercoffee.getCalculatorDefaults();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/bellwethercoffee/<function> - OpenAPI
/v1/sites/bellwethercoffee/openapi.json