myco2suite-carbon-intelligence

{
  "name": "myco2suite-carbon-intelligence",
  "description": "MyCO2 Carbon Intelligence API - Calculates carbon dioxide equivalent (CO2e) emissions for financial transactions, flights, freight, and physical activities, and computes EU CBAM (Carbon Border Adjustment Mechanism) embedded emissions and liability for imported goods. Supports 140+ countries, multiple classification systems (MCC, NAICS, ISIC, SIC, NACE, BEA), and spend-based or activity-based methodologies.",
  "url": "https://api.myco2suite.io/v1/a2a",
  "provider": {
    "organization": "MyCO2",
    "url": "https://myco2suite.io"
  },
  "version": "1.0.0",
  "protocolVersion": "0.3.0",
  "preferredTransport": "JSONRPC",
  "documentationUrl": "https://myco2suite.io/docs#agents",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "multiTask": true
  },
  "supportedInterface": "http+json",
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "spend_based_transaction_emissions",
      "name": "Spend-Based Carbon Emissions",
      "description": "Calculate CO2e emissions from a financial transaction amount using spend-based methodology. Supports MCC, BEA, NAICS, ISIC, SIC, NACE classification codes. Works across 140+ countries.",
      "tags": [
        "carbon",
        "emissions",
        "spend",
        "transaction",
        "mcc",
        "bea",
        "naics"
      ],
      "examples": [
        "{\"type\": \"spend_based_transaction_emissions\", \"mcc\": \"5411\", \"spend_amount\": 150.00, \"currency\": \"USD\", \"country\": \"US\"}",
        "{\"type\": \"spend_based_transaction_emissions\", \"naics\": \"5112\", \"spend_amount\": 500.00, \"currency\": \"GBP\", \"country\": \"GB\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "flight_emissions",
      "name": "Flight Carbon Emissions",
      "description": "Calculate CO2e emissions from flight details. Supports IATA airport codes, UN/LOCODE, and lat/long coordinates. Includes radiative forcing adjustment and cabin class support.",
      "tags": [
        "carbon",
        "emissions",
        "flight",
        "aviation",
        "travel"
      ],
      "examples": [
        "{\"type\": \"flight_emissions\", \"origin\": \"JFK\", \"destination\": \"LAX\", \"cabin_class\": \"economy\", \"trip_type\": \"one_way\"}",
        "{\"type\": \"flight_emissions\", \"origin\": \"LHR\", \"destination\": \"SIN\", \"cabin_class\": \"business\", \"trip_type\": \"return\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "activity_based_emissions",
      "name": "Activity-Based Carbon Emissions",
      "description": "Calculate CO2e from physical activities like driving, heating, flying. Uses activity-specific emission factors from EPA, DEFRA, and other authoritative sources.",
      "tags": [
        "carbon",
        "emissions",
        "activity",
        "energy",
        "transport"
      ],
      "examples": [
        "{\"type\": \"activity_based_emissions\", \"activity_type\": \"car_km\", \"quantity\": 500, \"country\": \"US\"}",
        "{\"type\": \"activity_based_emissions\", \"activity_type\": \"natural_gas_m3\", \"quantity\": 100, \"country\": \"GB\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "activity_batch",
      "name": "Activity Emissions \u2014 Batch",
      "description": "Calculate CO2e for up to 100 activities in one request; each item returns its own result or error and is billed as one call. Ideal for scoring many line items at once.",
      "tags": [
        "carbon",
        "emissions",
        "activity",
        "batch",
        "bulk"
      ],
      "examples": [
        "{\"type\": \"activity_batch\", \"calculations\": [{\"activity_type\": \"electricity\", \"quantity\": 500, \"country\": \"DE\"}, {\"activity_type\": \"natural_gas_m3\", \"quantity\": 100, \"country\": \"GB\"}]}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "emission_factor_lookup",
      "name": "Emission Factor Lookup",
      "description": "Look up emission factors by classification code (MCC, BEA, NAICS, etc.) or activity type. Returns factor value, unit, methodology, data year, and confidence level.",
      "tags": [
        "carbon",
        "emissions",
        "factors",
        "lookup",
        "reference"
      ],
      "examples": [
        "{\"type\": \"emission_factor_lookup\", \"classification_code\": \"5411\", \"classification_system\": \"mcc\", \"country\": \"US\"}",
        "{\"type\": \"emission_factor_lookup\", \"activity_type\": \"car_km\", \"country\": \"US\", \"year\": 2023}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "activity_types_list",
      "name": "Activity Types List",
      "description": "List all available activity types with their units, categories, and data sources. Use to discover what activities are supported for emission calculations.",
      "tags": [
        "carbon",
        "emissions",
        "activities",
        "reference",
        "discovery"
      ],
      "examples": [
        "{\"type\": \"activity_types_list\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "freight_emissions",
      "name": "Freight Carbon Emissions",
      "description": "Calculate CO2e emissions for freight transport by sea, road, rail, or air. Supports single-leg and multi-leg intermodal journeys. Locations accept UN/LOCODE (e.g. 'GBSOU'), IATA airport codes (e.g. 'LHR'), free-text names, or lat/lon coordinates.",
      "tags": [
        "carbon",
        "emissions",
        "freight",
        "shipping",
        "logistics",
        "sea",
        "road",
        "rail",
        "air",
        "intermodal"
      ],
      "examples": [
        "{\"type\": \"freight_emissions\", \"origin\": \"GBSOU\", \"destination\": \"NLRTM\", \"mode\": \"sea\", \"vehicle_type\": \"container\", \"weight_kg\": 10000}",
        "{\"type\": \"freight_emissions\", \"origin\": \"LHR\", \"destination\": \"JFK\", \"mode\": \"air\", \"weight_kg\": 500}",
        "{\"type\": \"freight_emissions\", \"weight_kg\": 10000, \"legs\": [{\"origin\": \"GBSOU\", \"destination\": \"NLRTM\", \"mode\": \"sea\", \"vehicle_type\": \"container\"}, {\"origin\": \"NLRTM\", \"destination\": \"DEHAM\", \"mode\": \"road\"}]}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "cbam_liability",
      "name": "CBAM Liability Calculator",
      "description": "Calculate EU Carbon Border Adjustment Mechanism (CBAM) embedded emissions and estimated EUR liability for an imported good. Covers Phase 1 sectors (cement, aluminium, iron & steel, fertilisers, hydrogen). Returns two scenarios \u2014 EU default values (with mark-up) and verified actual emissions \u2014 plus the year's phase-in rate, live ETS price, optional Article 9 deduction, and multi-year projection.",
      "tags": [
        "cbam",
        "carbon",
        "border",
        "tax",
        "eu",
        "import",
        "compliance"
      ],
      "examples": [
        "{\"type\": \"cbam_liability\", \"cn_code\": \"72061000\", \"origin_country\": \"IN\", \"weight_tonnes\": 1000}",
        "{\"type\": \"cbam_liability\", \"cn_code\": \"25231000\", \"origin_country\": \"CN\", \"weight_tonnes\": 500, \"year\": 2027, \"actual_emissions_tco2e_per_t\": 0.85, \"carbon_price_paid_eur_per_tonne\": 8, \"project\": true}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "cbam_batch",
      "name": "CBAM Portfolio Calculator",
      "description": "Calculate CBAM liability for up to 100 shipments in one request and return portfolio totals (embedded tCO2e, certificates, EUR liability, achievable saving). Per-item ok/not_covered/error.",
      "tags": [
        "cbam",
        "carbon",
        "border",
        "tax",
        "batch",
        "portfolio",
        "import"
      ],
      "examples": [
        "{\"type\": \"cbam_batch\", \"year\": 2026, \"shipments\": [{\"id\": \"PO-1\", \"cn_code\": \"72061000\", \"origin_country\": \"IN\", \"weight_tonnes\": 800}, {\"id\": \"PO-2\", \"cn_code\": \"25231000\", \"origin_country\": \"CN\", \"weight_tonnes\": 1200}]}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "cbam_cn_code_lookup",
      "name": "CBAM CN Code Lookup",
      "description": "Search the EU Combined Nomenclature for the 8-digit CN code of a product, check whether it is subject to CBAM (Phase 1) and which sector. Use the returned cn_code with the cbam_liability skill.",
      "tags": [
        "cbam",
        "cn-code",
        "lookup",
        "search",
        "nomenclature",
        "customs"
      ],
      "examples": [
        "{\"type\": \"cbam_cn_code_lookup\", \"q\": \"steel\"}",
        "{\"type\": \"cbam_cn_code_lookup\", \"sector\": \"cement\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "cbam_carbon_price_lookup",
      "name": "CBAM Origin Carbon Price Lookup",
      "description": "Look up the carbon price(s) in a country (World Bank Carbon Pricing Dashboard, CC BY 4.0) as an indicative starting figure for the carbon_price_paid (Article 9) input on cbam_liability. Returns instrument, type, price in USD and indicative EUR, and year. Indicative only \u2014 the importer must report the price actually paid on their goods, with proof.",
      "tags": [
        "cbam",
        "carbon-price",
        "article-9",
        "ets",
        "carbon-tax",
        "origin"
      ],
      "examples": [
        "{\"type\": \"cbam_carbon_price_lookup\", \"country\": \"CN\"}",
        "{\"type\": \"cbam_carbon_price_lookup\", \"country\": \"KR\", \"instrument_type\": \"ets\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "payment": {
    "protocol": "x402",
    "scheme": "exact",
    "network": "base",
    "networkId": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "assetSymbol": "USDC",
    "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
    "pricing": {
      "standardUsd": 0.003,
      "cbamUsd": 0.008
    },
    "description": "Pay per call in USDC on Base \u2014 no API key. Call any billable endpoint without a key to receive an HTTP 402 with payment requirements, pay via any x402 client, and retry with the X-PAYMENT header."
  }
}