{
  "name": "verdra_calculate_carbon_footprint",
  "description": "Estimate a company's annual carbon footprint with Verdra. Use when a user asks for a quick carbon baseline, needs input for a client questionnaire, RSE tender, supplier Scope 3 request, or CSRD readiness screening. Returns either a range or a detailed screening estimate with interpretation, likely hotspots, compliance signals, next steps, and methodological disclaimers. Do not use as a certified audit or legal filing.",
  "input_schema": {
    "type": "object",
    "properties": {
      "company_name": {
        "type": "string",
        "description": "Company name shown back in the result."
      },
      "country_code": {
        "type": "string",
        "description": "ISO country code. Defaults to FR. Non-FR companies receive an extra calibration disclaimer."
      },
      "calculation_mode": {
        "type": "string",
        "enum": ["quick", "detailed"],
        "description": "Use quick when you only know sector, employee band, and revenue band. Use detailed when you have activity data such as energy, office size, and flights."
      },
      "business_contexts": {
        "type": "array",
        "description": "Optional reasons why the estimate is needed. Helps Verdra tailor the interpretation to procurement, CSRD, or supplier workflows.",
        "items": {
          "type": "string",
          "enum": [
            "customer_carbon_request",
            "rse_tender",
            "csrd_screening",
            "supplier_scope3",
            "internal_baseline"
          ]
        }
      },
      "include_interpretation": {
        "type": "boolean",
        "description": "Defaults to true. Set false if you only want raw estimate fields."
      },
      "quick_sector": {
        "type": "string",
        "enum": [
          "industry",
          "transport_logistics",
          "services",
          "commerce",
          "agriculture_agro",
          "construction"
        ],
        "description": "Required in quick mode."
      },
      "employee_band": {
        "type": "string",
        "enum": ["1_10", "11_50", "51_250", "250_plus"],
        "description": "Required in quick mode."
      },
      "revenue_band": {
        "type": "string",
        "enum": ["lt_500k", "500k_2m", "2m_10m", "10m_50m", "gt_50m"],
        "description": "Required in quick mode."
      },
      "industry": {
        "type": "string",
        "enum": [
          "technology_software",
          "professional_services",
          "commerce_ecommerce",
          "industry_manufacturing",
          "healthcare",
          "construction_btp",
          "food_agriculture",
          "transport_logistics",
          "finance_insurance",
          "education_training",
          "other"
        ],
        "description": "Required in detailed mode."
      },
      "employees": {
        "type": "number",
        "description": "Headcount used in detailed mode."
      },
      "office_size_m2": {
        "type": "number",
        "description": "Office or site floor area in square meters, used in detailed mode."
      },
      "electricity_kwh_per_month": {
        "type": "number",
        "description": "Average monthly electricity consumption in kWh, used in detailed mode."
      },
      "gas_m3_per_month": {
        "type": "number",
        "description": "Average monthly gas consumption in cubic meters, used in detailed mode."
      },
      "short_flights_per_month": {
        "type": "number",
        "description": "Average number of short-haul flights per month, used in detailed mode."
      },
      "long_flights_per_month": {
        "type": "number",
        "description": "Average number of long-haul flights per month, used in detailed mode."
      }
    },
    "required": ["calculation_mode"]
  }
}