Available Tools
| Tool | Endpoint | Description |
|---|---|---|
get_categories | GET /api/v1/categories | GHG Protocol categories |
get_emission_factors | GET /api/v1/emission-factors/custom | Custom emission factors |
get_recommended_inputs | GET /api/v1/inputs/recommended | Recommended inputs by country |
get_suppliers | GET /api/v1/suppliers | Suppliers and clients |
get_waste_operators | GET /api/v1/waste-operators | Waste operators |
get_users | GET /api/v1/users | Organization users |
Usage Examples
"What GHG categories are available in Scope 3?"
→ get_categories({ level: "subcategory" })
"What are my company's custom emission factors?"
→ get_emission_factors({ companyId: "uuid" })
"What electricity inputs do you recommend for the US?"
→ get_recommended_inputs({ country: "US", type: "electricity" })
"List my company's suppliers"
→ get_suppliers({ companyId: "uuid" })
"Who are the users in my organization?"
→ get_users({ companyId: "uuid" })
GHG Category Levels
| Level | Description |
|---|---|
scope | Scope 1, 2, 3 |
category | Main categories (e.g. Stationary combustion) |
subcategory | Detailed subcategories (e.g. Natural gas, Gasoline E5) |
Use
get_categories?level=subcategory to get the categoryId needed when creating consumption records.