estimate_chat_usage
Estimate carbon, energy, and water use for chat exchanges from message counts, model, and region using SAEF emission factors for AI sustainability reporting.
Instructions
Estimate carbon, energy and water for chat usage, counted in messages, using SOMA AI Emission Factors (SAEF).
Each message is one chat exchange (a question and its answer) of 1,210 tokens, the dataset's short-chat default of 928 input and 282 output tokens. Long documents, coding agents and reasoning modes use far more tokens, so use estimate_footprint when you know the token count.
Args: messages: Number of chat exchanges. model: Model identifier such as "gpt-4o" or "claude-sonnet-4-5". region: Cloud region id, ISO-3 country code, eGRID subregion, "eu-27" or "global". Use list_regions to see options.
Same output as estimate_footprint, plus the token assumption used. All figures are estimates, not measurements.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"messages": "<messages>",
"model": "<model>"
},
"name": "estimate_chat_usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | ||
| region | No | global | |
| messages | Yes |