# MyCO2 Suite – Spend-Based Transaction Carbon Calculator

> MyCO2 Suite – Spend-Based Transaction Carbon Calculator is a paid API for AI agents from api.myco2suite.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Converts a transaction amount and industry classification code (MCC, NAICS, BEA, ISIC, SIC, or NACE) into a verified Scope 3 CO2e emission estimate using licensed emission factors with full provenance across 200+ countries.

## Facts

- Endpoint: POST https://api.myco2suite.io/api/v1/transaction?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/myco2-suite-spend-based-transaction-carbon-calculator-5dc40840
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uLrzkouDIGKNfxFuOMWmW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability myco2-suite-spend-based-transaction-carbon-calculator-5dc40840 -d '<json body>'
```

Example prompt: Calculate the Scope 3 CO2e emissions for a $1,200 USD business travel agency payment — the merchant category code is MCC 4722, billed in the United States — and give me the emission factor source and provenance.

## When to prefer this

Choose this endpoint when you have financial transaction data (spend amount + merchant/industry classification code) and need a spend-based Scope 3 CO2e estimate with licensed, auditable emission factors. It is ideal for corporate card analytics, fintech carbon labelling, ESG reporting pipelines, and supply-chain spend footprinting across 200+ countries. Prefer it over activity-based endpoints when physical quantities (litres of fuel, kWh) are unavailable and only spend data exists.

## Known failure modes

- Unsupported or invalid industry code (MCC/NAICS/BEA/ISIC/SIC/NACE) returns an error
- Unsupported country code returns a 400 or no-factor-available error
- Missing required fields (amount, currency, industry code) returns a validation error
- Ambiguous currency or zero/negative amount triggers a 422 unprocessable entity
- Payment failure (insufficient USDC balance for x402) blocks the call

## How this service works

Spend-based carbon (Scope 3): convert a transaction amount + industry code (MCC/NAICS/BEA/ISIC/SIC/NACE) into verified CO2e. 200+ countries, licensed emission factors with full provenance.

## Output

Returns a CO2e value (in kg or tonnes) for the given spend amount, along with the emission factor applied, its unit, calculation methodology, source dataset, licence information, and country/sector provenance — providing an audit-ready Scope 3 carbon estimate.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mcc": {
   "type": "string",
   "description": "Merchant Category Code (4 digits)"
  },
  "naics": {
   "type": "string",
   "description": "NAICS code (alt to mcc)"
  },
  "country": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2, e.g. US"
  },
  "bea_code": {
   "type": "string",
   "description": "US BEA industry code (alt to mcc)"
  },
  "currency": {
   "type": "string",
   "description": "ISO 4217 currency, e.g. USD"
  },
  "spend_amount": {
   "type": "number",
   "description": "Amount spent (>0)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/myco2-suite-spend-based-transaction-carbon-calculator-5dc40840/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.myco2suite.io](https://www.zero.xyz/host/api.myco2suite.io/llms.txt)