{
  "name": "verdra_calculate_carbon_footprint",
  "description": "Estimate a company's annual carbon footprint with Verdra for procurement, CSRD screening, supplier Scope 3 requests, or internal carbon baselining. Returns a screening range or activity-based screening estimate plus interpretation and disclaimers.",
  "parameters": {
    "type": "object",
    "properties": {
      "company_name": {
        "type": "string",
        "description": "Company name shown in the response."
      },
      "country_code": {
        "type": "string",
        "description": "ISO country code, default FR."
      },
      "calculation_mode": {
        "type": "string",
        "enum": ["quick", "detailed"],
        "description": "quick for coarse estimates, detailed for activity-based screening."
      },
      "business_contexts": {
        "type": "array",
        "description": "Optional list of use cases to tailor interpretation.",
        "items": {
          "type": "string",
          "enum": [
            "customer_carbon_request",
            "rse_tender",
            "csrd_screening",
            "supplier_scope3",
            "internal_baseline"
          ]
        }
      },
      "include_interpretation": {
        "type": "boolean",
        "description": "Defaults to true."
      },
      "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": "Required in detailed mode."
      },
      "office_size_m2": {
        "type": "number",
        "description": "Optional proxy input for detailed mode."
      },
      "electricity_kwh_per_month": {
        "type": "number",
        "description": "Optional proxy input for detailed mode."
      },
      "gas_m3_per_month": {
        "type": "number",
        "description": "Optional proxy input for detailed mode."
      },
      "short_flights_per_month": {
        "type": "number",
        "description": "Optional proxy input for detailed mode."
      },
      "long_flights_per_month": {
        "type": "number",
        "description": "Optional proxy input for detailed mode."
      }
    },
    "required": ["calculation_mode"]
  }
}