MCP 工具參考

端點 https://carbon.taux.io/mcp（Streamable HTTP，不需認證）。下列 11 個工具全部唯讀，由伺服器實際註冊的定義產生。

https://carbon.taux.io/mcp

ping：確認服務是否正常。
list_data_sources：列出已整合的官方資料來源與狀態。
search_emission_factors：以關鍵字、類別、年度搜尋排放係數。
get_emission_factor：取得單一係數的完整資訊與使用限制。
get_electricity_factor：查詢指定年度的台灣電力排碳係數。
calculate_emissions：用官方係數計算單一活動的排放量。
calculate_batch：批次計算多筆活動，條件相容時才給合計。
compare_emissions：比較兩筆排放量，區分活動量與係數的影響。
list_factor_versions：列出係數的歷史版本。
check_factor_updates：查看各資料來源的同步與更新狀態。
get_methodology：說明計算方法、適用範圍與資料限制。

`ping`

Ping

Check that the service is up. Returns status, service name, version and server time. 確認服務狀態，回傳狀態、服務名稱、版本與伺服器時間。

這個工具沒有參數。

`list_data_sources`

List data sources

List the official Taiwan government sources behind this service, with dataset codes, URLs, licence, sync status and how many factors each holds. 列出本服務整合的官方資料來源：資料集代碼、網址、授權、同步狀態與係數數量。

這個工具沒有參數。

`search_emission_factors`

Search emission factors

Search official Taiwan emission factors by keyword, category, type, year or unit. Returns factor IDs to pass to get_emission_factor and calculate_emissions. Covers electricity, tap water and fuel combustion; returns an explicit not-found message rather than a near match. 以關鍵字、類別、類型、年度或單位搜尋台灣官方排放係數，回傳的係數 ID 可交給 get_emission_factor 與 calculate_emissions。目前收錄電力、自來水與燃料燃燒；查不到會明確說明，不會給相近的替代品。

參數	型別	必填	說明
`query`	`string`	選填	關鍵字，繁體中文或英文，例如電力、柴油、自來水、gasoline。多個關鍵字以空白分隔。
`category`	`electricity \| water \| fuel_combustion \| product_footprint`	選填	類別：electricity 電力、water 自來水、fuel_combustion 燃料燃燒、product_footprint 產品碳足跡。
`factor_type`	`purchased_electricity \| water_supply \| stationary_combustion \| mobile_combustion \| product_carbon_footprint`	選填	係數類型，用來區分固定燃燒與移動燃燒等。
`year`	`integer`	選填	適用年度（西元）。
`unit`	`string`	選填	係數分母的單位，例如 kWh、m3、TJ。
`limit`	`integer`	選填	回傳筆數，預設 10，上限 50。
`offset`	`integer`	選填	略過前幾筆（分頁用）。

`get_emission_factor`

Get emission factor

Get one factor in full by ID: the original government record, unit, applicable year, boundary, official source, version, whether it can be used for calculation directly, and usage limits. Find the ID with search_emission_factors first. 依係數 ID 取得完整資訊：官方原始紀錄、單位、適用年度、計算邊界、官方來源、版本、是否可直接計算與使用限制。請先用 search_emission_factors 找到 ID。

參數	型別	必填	說明
`factor_id`	`string`	必填	係數 ID，來自 search_emission_factors。
`version`	`integer`	選填	指定版本；不給就是目前版本。

`get_electricity_factor`

Get electricity factor

Get Taiwan's official electricity emission factor (kgCO2e/kWh) for a given year, published by the Energy Administration. From the 2025 factor year there are three values by usage; earlier years have one. Never substitutes another year: if the year is missing it says so and lists the years available. 查詢經濟部能源署公布的指定年度電力排碳係數（公斤CO2e/度）。114 年度（2025）起依用途有三個數值，之前每年一個。不會以其他年度代替：該年度沒有資料時會明說並列出可用年度。

參數	型別	必填	說明
`year`	`integer`	必填	適用年度（西元），例如 2025。
`usage_type`	`utility_average \| industry_inventory \| residential_tariff`	選填	用途別（114 年度起才有劃分）：industry_inventory 產業盤查使用；residential_tariff 表燈非營業與包燈用戶；utility_average 公用售電業整體平均。不給就回該年度全部數值。

`calculate_emissions`

Calculate emissions

Calculate emissions for one activity: activity data × an official factor from the database. Checks units, the applicable year and whether the factor may be used for calculation, and returns the formula, kg and tonnes, the factor version and the source URL. Returns a clear error instead of guessing when the unit is incompatible, the year does not match or required data is missing (fuel factors need a user-supplied lower heating value). 計算單一活動的排放量：活動數據 × 資料庫中的官方係數。會檢查單位、適用年度與係數是否可用於計算，回傳公式、公斤與公噸、係數版本與來源網址。單位不相容、年度不符或缺少必要資料時（燃料係數需要使用者提供低位熱值）回傳明確錯誤，不會猜測。

參數	型別	必填	說明
`factor_id`	`string`	必填	係數 ID，來自 search_emission_factors 或 get_electricity_factor 的結果。請勿自行猜測。
`quantity`	`number \| string`	必填	活動數據，不小於零。可用數字或十進位字串（字串可避免精度問題），例如 12000 或 "17.495"。
`quantity_unit`	`string`	必填	活動數據的單位，例如 kWh、度、L、公秉、kg、t、m3。「度」在電是 kWh、在水是 m³。
`year`	`integer`	選填	活動發生的年度（西元）。有給就必須與係數的適用年度相符，不會自動以其他年度代替。
`optional_context`	`object`	選填	補充資料。燃料燃燒係數需要 lower_heating_value。
`optional_context.lower_heating_value`	`object`	選填	低位熱值。燃料燃燒係數必填，必須來自使用者（自行檢測或供應商提供）；官方沒有預設值，請勿自行假設。
`optional_context.lower_heating_value.value`	`number \| string`	必填	低位熱值的數值，例如 8500。
`optional_context.lower_heating_value.unit`	`string`	必填	單位，寫成 "kcal/L"、"kcal/kg" 或 "kcal/m3"。
`factor_version`	`integer`	選填	指定係數版本，用來重現過去的計算。不給就用目前版本。

`calculate_batch`

Calculate batch

Calculate several activities at once, each with its own factor and source. A total is given only when every item succeeded and the items share a gas basis and boundary type; otherwise the reason is stated. 批次計算多筆活動，逐筆回傳結果與來源。只有全部成功、氣體基礎與邊界類型一致時才提供合計，否則說明不提供的原因。

參數	型別	必填	說明
`items`	`object[]`	必填	要計算的活動，最多 50 筆。
`items[].factor_id`	`string`	必填	係數 ID，來自 search_emission_factors 或 get_electricity_factor 的結果。請勿自行猜測。
`items[].quantity`	`number \| string`	必填	活動數據，不小於零。可用數字或十進位字串（字串可避免精度問題），例如 12000 或 "17.495"。
`items[].quantity_unit`	`string`	必填	活動數據的單位，例如 kWh、度、L、公秉、kg、t、m3。「度」在電是 kWh、在水是 m³。
`items[].year`	`integer`	選填	活動發生的年度（西元）。有給就必須與係數的適用年度相符，不會自動以其他年度代替。
`items[].optional_context`	`object`	選填	補充資料。燃料燃燒係數需要 lower_heating_value。
`items[].optional_context.lower_heating_value`	`object`	選填	低位熱值。燃料燃燒係數必填，必須來自使用者（自行檢測或供應商提供）；官方沒有預設值，請勿自行假設。
`items[].optional_context.lower_heating_value.value`	`number \| string`	必填	低位熱值的數值，例如 8500。
`items[].optional_context.lower_heating_value.unit`	`string`	必填	單位，寫成 "kcal/L"、"kcal/kg" 或 "kcal/m3"。
`items[].factor_version`	`integer`	選填	指定係數版本，用來重現過去的計算。不給就用目前版本。

`compare_emissions`

Compare emissions

Compare two calculations (for example two years). Separates the effect of changed activity data from the effect of a changed factor, and flags when the calculation method differs so the difference is not read as an actual reduction. 比較兩筆計算（例如不同年度）。區分活動量改變與排放係數改變的影響；計算方法不同時會標示，避免把差異誤讀為實際減碳成效。

參數	型別	必填	說明
`baseline`	`object`	必填	基準（例如去年）。
`baseline.factor_id`	`string`	必填	係數 ID，來自 search_emission_factors 或 get_electricity_factor 的結果。請勿自行猜測。
`baseline.quantity`	`number \| string`	必填	活動數據，不小於零。可用數字或十進位字串（字串可避免精度問題），例如 12000 或 "17.495"。
`baseline.quantity_unit`	`string`	必填	活動數據的單位，例如 kWh、度、L、公秉、kg、t、m3。「度」在電是 kWh、在水是 m³。
`baseline.year`	`integer`	選填	活動發生的年度（西元）。有給就必須與係數的適用年度相符，不會自動以其他年度代替。
`baseline.optional_context`	`object`	選填	補充資料。燃料燃燒係數需要 lower_heating_value。
`baseline.optional_context.lower_heating_value`	`object`	選填	低位熱值。燃料燃燒係數必填，必須來自使用者（自行檢測或供應商提供）；官方沒有預設值，請勿自行假設。
`baseline.optional_context.lower_heating_value.value`	`number \| string`	必填	低位熱值的數值，例如 8500。
`baseline.optional_context.lower_heating_value.unit`	`string`	必填	單位，寫成 "kcal/L"、"kcal/kg" 或 "kcal/m3"。
`baseline.factor_version`	`integer`	選填	指定係數版本，用來重現過去的計算。不給就用目前版本。
`comparison`	`object`	必填	比較對象（例如今年）。
`comparison.factor_id`	`string`	必填	係數 ID，來自 search_emission_factors 或 get_electricity_factor 的結果。請勿自行猜測。
`comparison.quantity`	`number \| string`	必填	活動數據，不小於零。可用數字或十進位字串（字串可避免精度問題），例如 12000 或 "17.495"。
`comparison.quantity_unit`	`string`	必填	活動數據的單位，例如 kWh、度、L、公秉、kg、t、m3。「度」在電是 kWh、在水是 m³。
`comparison.year`	`integer`	選填	活動發生的年度（西元）。有給就必須與係數的適用年度相符，不會自動以其他年度代替。
`comparison.optional_context`	`object`	選填	補充資料。燃料燃燒係數需要 lower_heating_value。
`comparison.optional_context.lower_heating_value`	`object`	選填	低位熱值。燃料燃燒係數必填，必須來自使用者（自行檢測或供應商提供）；官方沒有預設值，請勿自行假設。
`comparison.optional_context.lower_heating_value.value`	`number \| string`	必填	低位熱值的數值，例如 8500。
`comparison.optional_context.lower_heating_value.unit`	`string`	必填	單位，寫成 "kcal/L"、"kcal/kg" 或 "kcal/m3"。
`comparison.factor_version`	`integer`	選填	指定係數版本，用來重現過去的計算。不給就用目前版本。

`list_factor_versions`

List factor versions

List every recorded version of one factor, newest first. Old versions are kept so past calculations can be reproduced. 列出指定係數的所有歷史版本（新的在前）。舊版本會保留，讓過去的計算可以重現。

參數	型別	必填	說明
`factor_id`	`string`	必填	係數 ID，來自 search_emission_factors。

`check_factor_updates`

Check factor updates

Show the sync status of each official source: when it was last checked, whether the data may be stale, and whether a difference from the official data is waiting for review. Read-only; it cannot trigger a sync or write anything. 查看各官方來源的同步狀態：最近檢查時間、資料是否可能過期、是否有與官方資料不一致而待審核的項目。唯讀，不能觸發同步或寫入。

這個工具沒有參數。

`get_methodology`

Get methodology

Explain the calculation methods, scope, data limits and official references. Read this before interpreting results or combining different kinds of factors. 說明計算方法、適用範圍、資料限制與官方依據。解讀結果或合併不同類型的係數之前請先閱讀。

參數	型別	必填	說明
`topic`	`overview \| electricity \| fuel_combustion \| water \| product_footprint \| units \| limitations`	選填	主題；不給就回全部。