Ecologi MCP integration for AI agents.
Connect AI agents to Ecologi through 10 structured actions, including get carbon offset totals, purchase carbon avoidance, and get carbon removal totals. Rev…
- ACTION CONTRACTS
- 10
- AUTHENTICATION
- API key
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the Ecologi integration exposes
The Ecologi Agent App exposes 10 provider-backed actions for finance and data work. Its current contract lets an authorized agent get the confirmed and pending tonnes of carbon emissions avoided by an ecologi user, purchase ecologi carbon avoidance by kilograms or tonnes, and get the confirmed and pending tonnes of carbon removed by an ecologi user. These operations are called through Working Machines as typed capabilities rather than through browser navigation or copied UI steps.
A connection uses API key. Before execution, the agent can inspect the selected action, its required fields, declared scopes, and expected output contract. Provider credentials remain inside the Working Machines runtime; the calling agent receives the capability and its structured result, not the underlying secret.
For reliable operation, start with the narrowest action that satisfies the task, resolve stable provider identifiers before changing state, and validate the returned object or status after execution. Availability still depends on the connected Ecologi account, granted provider permissions, workspace policy, region, plan, and upstream API behavior.
VERIFIED ACTION SAMPLE
Real Ecologi capabilities.
Showing 10 of 10 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
get_carbon_offset_totalsREADGet the confirmed and pending tonnes of carbon emissions avoided by an Ecologi user.
INPUTS: username
purchase_carbon_avoidanceREVIEWPurchase Ecologi carbon avoidance by kilograms or tonnes.
INPUTS: number / units / name / test / recipientEmail
get_carbon_removal_totalsREADGet the confirmed and pending tonnes of carbon removed by an Ecologi user.
INPUTS: username
get_habitat_restoration_totalsREADGet the confirmed and pending square metres of habitat restored by an Ecologi user.
INPUTS: username
get_total_impactREADGet a combined view of an Ecologi user's confirmed and pending impact totals.
INPUTS: username
get_tree_totalsREADGet the confirmed and pending number of trees funded by an Ecologi user.
INPUTS: username
purchase_carbon_removalREVIEWPurchase permanent Ecologi carbon removal measured in kilograms.
INPUTS: number / name / test / recipientEmail / idempotencyKey
purchase_habitat_restorationREVIEWPurchase Ecologi habitat restoration measured in square metres.
INPUTS: number / name / test / recipientEmail / idempotencyKey
purchase_local_treesREVIEWPurchase Ecologi tree planting in the UK, US, Australia, or Brazil.
INPUTS: number / country / name / test / recipientEmail
purchase_treesREVIEWPurchase Ecologi tree planting with optional test mode, attribution, notification, and idempotency.
INPUTS: number / name / test / recipientEmail / idempotencyKey
INPUT CONTRACTS
Know what the action needs before it runs.
get_carbon_offset_totals
usernameREQUIRED- The Ecologi username used by the public reporting API.
purchase_carbon_avoidance
numberREQUIRED- The number of carbon avoidance units to purchase.
unitsREQUIRED- The unit used for the carbon avoidance purchase.
nameOPTIONAL- An optional funded-by name shown on the Ecologi profile. If the profile is public, obtain permission before sending personally identifiable information or use a non-identifying label.
testOPTIONAL- Whether to simulate the purchase without charging or publishing impact.
recipientEmailOPTIONAL- An optional third-party recipient email for an Ecologi impact notification. The account-gated feature returns 403 when disabled; test mode validates and echoes the address without sending email.
get_carbon_removal_totals
usernameREQUIRED- The Ecologi username used by the public reporting API.
get_habitat_restoration_totals
usernameREQUIRED- The Ecologi username used by the public reporting API.
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Inspect Get Carbon Offset Totals
Get the confirmed and pending tonnes of carbon emissions avoided by an Ecologi user. Use this as a bounded discovery step, retain the returned identifier, and avoid expanding the read beyond the task's stated scope.
get_carbon_offset_totalsVerify with Get Carbon Removal Totals
Get the confirmed and pending tonnes of carbon removed by an Ecologi user. Compare the returned provider state with the intended outcome and preserve stable IDs or canonical links in the run record.
get_carbon_removal_totalsSAFETY BOUNDARY
Operate Ecologi with explicit limits
- Authorize Ecologi with API key and grant only the provider access required by the selected actions.
- The current action names appear read-oriented, but returned Ecologi data may still be sensitive and should be minimized before it enters model context.
- Do not infer permission from catalog visibility. Workspace policy, connection identity, and upstream authorization still govern execution.
- No provider scope string is declared on the sampled actions. Verify the connected account's actual permissions in Ecologi rather than assuming unrestricted access.
- After a call, inspect the structured result and execution record before reporting that the Ecologi task completed successfully.
CONNECTION MODEL
API key
Ecologi API key sent as a Bearer token. Find your key on the official Impact API page: https://ecologi.com/impact-api.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 5
- WRITE SIGNALS
- 0
- HIGH IMPACT
- 0
- REVIEW SIGNALS
- 5
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by Ecologi.