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/bellwethercoffee
Every 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/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 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

    NameTypeRequired
    currencyBellwethercoffeeCurrencyYes
    roasterTypeBellwethercoffeeRoasterTypeYes
    poundsWeeklynumber
    Weekly roasted-coffee usage (lb, or kg for non-USD).
    Yes
    coffeeCostnumber
    What the caller currently pays per lb/kg, in currency.
    Yes
    retailBagsnumber
    Retail 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/computeRoiEstimate

    Call it

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bellwethercoffee.getCalculatorDefaults();

Use it from code