# Cloverly MCP MCP

> Cloverly lets you manage carbon emissions and offsets right where transactions happen. Connect your Cloverly account to any AI client, and your agent takes over sustainability compliance. You can calculate real-time footprints for shipments or flights, buy verified carbon credits, and pull detailed reports on every purchase—all through natural conversation.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** carbon-offsetting, sustainability, emissions-tracking, logistics-analytics, environmental-impact, carbon-credits

## Description

You can take full control of your company's climate goals using this MCP. Instead of manually tracking emissions in spreadsheets or logging into a portal just to check balances, you simply ask your AI client for an update. Your agent calculates the carbon footprint for anything—freight, travel, energy usage—and immediately tells you what it costs to offset that impact. Need to buy credits? You prompt your agent to execute the purchase using verified projects like reforestation or solar farms. The system keeps a clean record of every transaction, giving you detailed receipts and certificates for easy reporting. Because this MCP is hosted on Vinkius, you get instant access to robust carbon management workflows from any compatible AI client, making sustainability compliance feel as natural as sending an email.

## Tools

### check_cloverly_status
Verifies that your connection to Cloverly is currently active and functioning correctly.

### create_estimate
Generates a preliminary carbon footprint calculation based on provided data inputs.

### create_purchase
Initiates the purchase of certified carbon offsets using specified funds or credits.

### get_account
Retrieves current account-level information, such as balance and overall usage limits.

### get_estimate
Fetches the specific details of a previously run carbon footprint estimate.

### get_impact_by_type
Retrieves calculated impact data categorized by source, such as 'shipping' or 'aviation'.

### get_impact_summary
Pulls a high-level summary report of all tracked environmental impacts.

### get_project
Retrieves detailed information about a specific carbon offset project, including its location and impact type.

### get_purchase
Fetches all the details for an individual, completed offset purchase transaction.

### list_estimates
Shows a list of all carbon footprint estimates that have been run on your account.

### list_projects
Retrieves the full directory and names of available offset projects for selection.

### list_purchases
Displays a complete list of all previous carbon credit purchases made through Cloverly.

## Prompt Examples

**Prompt:** 
```
Calculate the carbon footprint for a 10kg shipment from Berlin to Paris.
```

**Response:** 
```
Footprint calculated! Shipping your 10kg package results in approximately 1,200g of CO2 emissions. The cost to offset this is $0.15 USD. Shall I proceed with the purchase using your default project?
```

**Prompt:** 
```
List the available reforestation projects on Cloverly.
```

**Response:** 
```
I've retrieved the project directory. Currently, you can support: 'Amazon Rainforest Protection' (ID: prj_123), 'US Heritage Forests', and 'Mangrove Restoration'. Which one would you like more details on?
```

**Prompt:** 
```
Show the status of my latest offset purchase 'pur_456'.
```

**Response:** 
```
Monitoring purchase... Offset pur_456 is 'Confirmed'. I've retrieved your high-fidelity carbon certificate. You can view the digital receipt here: [receipt_url]. Need help with another sustainability report?
```

## Capabilities

### Calculate Carbon Footprints
Ask your agent to calculate the estimated emissions for specific activities, like a package shipment or a flight route.

### Automate Offset Purchases
Have your agent execute the purchase of verified carbon credits based on calculated needs or fixed dollar amounts.

### View Project Sources
Retrieve details on environmental projects (wind, solar, etc.) to verify where your offset funds are going.

### Monitor Transaction History
Check the status of past purchases and retrieve detailed metadata, receipts, and certificates for auditing purposes.

### Review Account Status
Get an overview of your entire account balance or check if the connection between your AI client and Cloverly is active.

## Use Cases

### Auditing Quarterly Emissions
The Sustainability Analyst needs to prove where their company's emissions came from last quarter. They ask the agent for a summary, which uses `get_impact_summary` and then calls `list_estimates` to back up every figure with specific calculation data.

### Handling an Unexpected Shipment
A Logistics Manager gets an unscheduled emergency shipment. Instead of calling a third party, they ask the agent for a footprint estimate (`create_estimate`) and immediately use `create_purchase` to cover the cost without delay.

### Onboarding New Employees
The HR team needs to educate new employees on responsible spending. They use the MCP to show examples by calling `get_impact_by_type`, illustrating how different types of travel impact the company's carbon goals.

### Verifying Offset Claims
A Compliance Officer needs proof that a specific offset purchase was valid. They use `list_purchases` to find the transaction ID, then call `get_purchase` to pull the original certificate and project details.

## Benefits

- You get instant visibility into environmental impact. Instead of sifting through spreadsheets, you can ask your agent to run `get_impact_summary` and get a clear overview of all tracked carbon sources.
- Automate compliance immediately after an event. If a shipment is logged, the AI calculates the footprint using `create_estimate` and prompts you to buy credits with one command, minimizing manual risk.
- Maintain perfect records for reporting. Running `list_purchases` or checking a single transaction via `get_purchase` instantly delivers detailed metadata, certificates, and receipts needed for audits.
- Know exactly where your money goes. By using tools like `list_projects` or `get_project`, you see the name and location of the actual environmental project receiving your offset funds, adding credibility to your efforts.
- Seamlessly integrate carbon action into existing codebases. Growth Engineers can call this MCP directly to inject real-time carbon calculation into internal applications.

## How It Works

The bottom line is that your AI client acts as a dedicated sustainability coordinator, handling calculations and purchases without requiring you to navigate multiple websites or use manual spreadsheets.

1. Connect this MCP to your preferred AI client using your API keys, making sure it's authorized to handle transactions.
2. Ask your agent a specific question, like 'What is the carbon cost for shipping 50kg from London?'
3. Your agent responds with the footprint and provides an option to buy credits, which you confirm to complete the offset.

## Frequently Asked Questions

**How do I check if the MCP is working with check_cloverly_status?**
Use `check_cloverly_status` to instantly verify that your connection is active. This tool confirms your access and makes sure you can run calculations or purchases without hitting a dead end.

**What's the difference between list_estimates and get_estimate?**
You use `list_estimates` to see a summary of all footprint reports you’ve previously generated. Use `get_estimate` when you know which specific report ID you need details for.

**Can I use the MCP to list available offset projects? (list_projects)**
Yes, running `list_projects` pulls up your complete directory of eligible environmental projects. This lets you choose exactly where your carbon credits will be invested.

**How do I make a purchase with the create_purchase tool?**
You initiate purchases by calling `create_purchase`. The MCP needs to know whether you are buying based on a calculated need or a specific fixed currency amount for that transaction.

**Does get_impact_summary show everything? (get_impact_summary)**
No, `get_impact_summary` gives a high-level snapshot. If you need to drill down—say, only looking at shipping impacts—you must use `get_impact_by_type`.

**What kind of data does the list_purchases tool return?**
It retrieves a full record of your carbon offset transactions. You get key details like purchase dates, associated project IDs, and amounts for comprehensive compliance reporting.

**If I use the get_project tool, what metadata can I retrieve about an environmental initiative?**
This tool pulls deep metadata on a specific offset source. You'll see details like the project type (e.g., solar or reforestation) and its geographical location, helping you verify where your credits are applied.

**How do I use get_account to check my overall sustainability status?**
It provides high-level account data immediately. You'll see your current total offset balance, available credit limits, and metadata needed for coordinating large-scale climate action plans.

**How do I find my Cloverly API Keys?**
Log in to your account, navigate to **Settings** > **API**, and you will find your Public and Private keys for both Production and Sandbox environments.

**Can I calculate carbon for shipping packages?**
Yes! The `create_estimate` tool allows you to provide weight and distance parameters to get an accurate carbon footprint for logistics.

**How do I retrieve a carbon certificate?**
After a successful purchase, use the `get_purchase_status` tool to retrieve the unique certificate and receipt URL for your record.