Bloomy Earth Plant Trees

Estimate the CO2e of AI usage using Bloomy Earth's task-based heuristic: 1.5 g per standard text response, 15 g per complex task (reasoning, coding, analysis), 25 g per generated image. Also converts grams or a volume of standard queries into a suggested number of trees (1 tree ~ 50,000 g CO2e ~ 33,333 standard queries). Illustrative estimate, not a measurement.

estimate_ai_footprint

Return Bloomy Earth's estimation methodology: the three task tiers, the tree equivalence, wording rules (climate contribution, never offset or neutralize) and the public methodology link. Use when the user asks how the estimate is calculated.

get_methodology

Return the authenticated Bloomy Earth organization's Tree Credit balance and organization ID (GET /v1/credits). Use before action tools so the user knows what they can spend.

get_credit_balance

Fetch the authenticated organization's tree planting certificates (GET /v1/certificates). Paginated summary by default; use view detail for full project/gift data, or pass certificateId for one specific certificate.

list_certificates

Offset a tonnage of CO2 through the Bloomy Earth API (POST /v1/offset-by-tonne) using the signed-in user's Tree Credits: each tonne plants 20 trees on the public certificate. Set vcs true to additionally attach a VCS-certified offset (+10 Tree Credits per tonne; the VCS certificate is issued within ~15 days by email). This action is server-enforced in two calls: first call offset_co2_by_tonne with the intended arguments and NO confirmationCode — nothing is spent, the result reads 'not executed — confirmation required' and carries a one-time confirmationCode; summarize the action for the user and, only after they explicitly confirm, call offset_co2_by_tonne again with EXACTLY the same arguments plus that confirmationCode to execute. The code works once, expires after about 5 minutes, and redeems only for this account, client and argument set.

offset_co2_by_tonne

Plant real trees through the Bloomy Earth API (POST /v1/trees) using the signed-in user's Tree Credits and generate a public planting certificate. If projectId is omitted, Bloomy Earth auto-selects a 1-credit-per-tree reforestation project. Supports gifting to another person. This action is server-enforced in two calls: first call plant_trees with the intended arguments and NO confirmationCode — nothing is planted, the result reads 'not executed — confirmation required' and carries a one-time confirmationCode; summarize the action for the user and, only after they explicitly confirm, call plant_trees again with EXACTLY the same arguments plus that confirmationCode to execute. The code works once, expires after about 5 minutes, and redeems only for this account, client and argument set.

plant_trees

Publish an activity update on the signed-in organization's public Bloomy Earth profile (POST /v1/post-activity). Accepts plain text or safe HTML (p, h3, h4, img after heading normalization). Limits: title up to 120 characters, content up to 3000 plain-text characters; rate limit 1 post per minute and 20 posts per rolling 24 hours. The post is publicly visible: show the user the exact title and the FULL content yourself — the confirmation result echoes the full content. This action is server-enforced in two calls: first call post_activity with the intended title and content and NO confirmationCode — nothing is posted, the result reads 'not executed — confirmation required' and carries a one-time confirmationCode; summarize the exact content for the user and, only after they explicitly confirm, call post_activity again with EXACTLY the same arguments plus that confirmationCode to execute. The code works once, expires after about 5 minutes, and redeems only for this account, client and argument set.

post_activity