GHG Protocol Corporate Standard emissions calculator with CLI and MCP interfaces
Server has 8 tools with clear verb-noun naming and reasonable descriptions (avg 150 chars). All tools have documented input schemas with types. However, parameter descriptions are inconsistent, some are detailed, others generic. Output schemas are partially documented in code but not formally declared in tool definitions. Error handling is minimal; no recovery guidance or actionable error messages. Missing tool annotations (readOnlyHint, idempotentHint). Composition is sound: tools are single-purpose and chainable. Security is adequate (no secrets in params, read-only operations). Baseline: 549 production tools average 18-char names (these are 15-22 chars, good); 194-char descriptions (these average ~140 chars, slightly short); 100% of A+ tools have param descriptions (this server ~70%).
Calculate GHG emissions for multiple activity records. Returns a complete inventory with scope breakdowns.
Calculate GHG emissions for a single activity.
Convert between units commonly used in GHG calculations. Supports energy (kWh, BTU, therm, MMBtu), mass (kg, lb, short_ton), volume (gallon, liter), and more.
Generate a summary report from activity records.
Search the emission factor database.
Get Global Warming Potential (GWP) values.
List all available emission factor databases with metadata.
Output schemas not formally documented in tool definitions. Code shows return dicts but no schema declaration visible in @mcp.tool() decorators. LLMs cannot infer response structure without explicit schema.
No tool annotations (readOnlyHint, idempotentHint, destructiveHint). All 8 tools are read-only but this is not declared. Agents cannot distinguish safe-to-retry operations without explicit hints.
Error handling lacks recovery guidance. No try-catch blocks visible in tool implementations. If Scope enum parsing fails (e.g. invalid scope value), error message is not actionable. LLM cannot self-correct.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
List all available emission scopes and their categories. Returns complete taxonomy of scopes, categories, and descriptions.
Parameter descriptions vary in quality. 'region' in calculate_single is described as 'Grid subregion (eGRID code) or country code' (good), but 'category' is vague: 'Scope category (e.g., "stationary_combustion", or "1"-"15" for scope 3)'. No enum constraint; LLM must infer valid values.
list_scopes and list_factor_sources have empty input schemas ({}). Descriptions are brief (65-70 chars). No indication of what data structure is returned or when to call them relative to other tools.