Skip to content

Bloomy Earth MCP

Bloomy Earth is a remote MCP (Model Context Protocol) server hosted on Cloudflare Workers, packaged as an agent plugin (ChatGPT / Codex) together with a climate-awareness skill. It connects AI carbon-footprint awareness to real-world climate action: estimate the CO2e of AI usage, then plant trees, offset CO2 by tonne, check your certificates, or publish a community activity — without leaving the conversation.

Endpoint

Every supported host connects to the same endpoint: https://mcp.bloomy.earth/mcp — the canonical URL, with no trailing slash.

OAuth discovery, client registration and sign-in all happen from that one URL; nothing else has to be configured by hand.

What you can do

The server exposes exactly seven tools:

  • estimate_ai_footprint — energy-first estimate of AI usage, either from token counts the host supplies or from flat-rate per-request constants. Returns the estimation mode, the size bucket each entry routed to and client-asserted provenance.
  • get_methodology — the live methodology copy: energy-first model, size buckets and wording rules.
  • get_credit_balance — the Tree Credit balance of the connected account.
  • list_certificates — paginated certificates for the connected account.
  • plant_trees — plants real trees (a specific project, or as a gift) and returns a public certificate link.
  • offset_co2_by_tonne — offsets CO2 by the tonne, with an optional certified offset.
  • post_activity — publishes an activity to the connected account's public Bloomy Earth profile.

The first four are read-only and need the mcp:read scope. The last three are write actions, need mcp:write, and are covered by the confirmation floor described below.

Your account, your credentials

Bring your own Bloomy Earth account. Sign-in asks for your own Dashboard → Integration API credentials (username + application password). There are no operator-held secrets — the server verifies your credentials live against the Bloomy API before issuing your token. Credentials belong only in the OAuth browser flow, never in config files or chat.

One permission row. The consent page renders one permission row per request. Reading the account and taking climate actions are granted together, or not at all: there is no independent read-only grant to combine with write, and no way to select write without read.

Two-call confirmation. Every write tool requires two calls: the first executes nothing and returns a one-time code plus a summary of exactly what the second call would do; only the second call, repeating the identical arguments with that code, spends or publishes anything. Declining or ignoring the first call spends nothing.

Estimates are illustrative

Footprint figures are illustrative estimates, not measurements of electricity consumption or actual emissions from AI infrastructure, and are not verified carbon-accounting data. Bloomy Earth always talks about climate contribution and responsibility — never about offsetting or neutralizing AI emissions.

Learn more