# Ecologi — how to use (mcp.ai)

Connect your Ecologi account and use 5 tools for news and lifestyle straight from your AI agent. Connect with your own API key. Ecologi is the platform for collective climate action. Purchase trees and carbon offsets programmatically through their Impact API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_ecologi?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `ecologi_get_user_carbon_offset`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/ecologi`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/ecologi/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/ecologi/get/user/carbon/offset` — Tool to get the total tonnes of CO2e emissions a user has avoided (carbon offset). Data refreshes every 10 minutes. No authentication required.
  - body: { username: string }
- `POST https://api.mcp.ai/api/ecologi/get/user/carbon/removal` — Tool to retrieve the total tonnes of CO₂e a user has permanently removed from the atmosphere. Data refreshes every 10 minutes. Use when checking carbon offset impact for a specific Ecologi user or bus
  - body: { username: string }
- `POST https://api.mcp.ai/api/ecologi/get/user/habitat/restoration` — Tool to get the total area of habitat and ecosystem a user has restored. Data refreshes every 10 minutes. No authentication required.
  - body: { username: string }
- `POST https://api.mcp.ai/api/ecologi/get/user/impact` — Tool to get a combination of all impact types a user has funded: trees, carbon avoidance, carbon removal, and habitat restoration, in a single request. Data refreshes every 10 minutes and no authentic
  - body: { username: string }
- `POST https://api.mcp.ai/api/ecologi/get/user/trees` — Tool to get the total number of trees a user has funded on Ecologi. Use when you need to retrieve tree statistics for a specific user. Data refreshes every 10 minutes.
  - body: { username: string }

## Example prompts
- "What can I do in Ecologi?"
- "Show me a summary of my Ecologi account"

## More
- Page: https://mcp.ai/ecologi
- Agent spec (llms.txt): https://mcp.ai/ecologi/llms.txt
- Postman collection: https://mcp.ai/ecologi/postman.json