Skip to content
Engineering Decision Intelligence
ReferenceVersion 0.4.1

openLCA MCP tool reference

Reference map for the 28 tools in the current public openLCA MCP 0.4.1 release.

Connection and health — 2 tools

  • test_connection — verify the selected openLCA IPC connection.
  • health_check — check reachability and optionally count entities.

Goal/scope and discovery — 8 tools

  • search_flows
  • search_processes
  • search_product_systems
  • inspect_product_system
  • list_impact_methods
  • search_impact_methods
  • find_providers
  • get_entity_by_name

Inventory writes — 3 tools

  • create_product_flow
  • create_process
  • create_product_system

Warning

These tools mutate the active database and are blocked when OPENLCA_READ_ONLY=true.

Impact assessment and result access — 5 tools

  • calculate_impacts
  • get_inventory_results
  • get_total_requirements
  • get_normalized_impacts
  • get_weighted_impacts

Interpretation and analysis — 8 tools

  • check_result_consistency
  • analyze_contributions
  • get_contribution_tree
  • get_sankey
  • compare_systems
  • run_monte_carlo
  • run_scenario_analysis
  • export_results

Result lifecycle — 2 tools

  • dispose_result
  • dispose_all_results

calculate_impacts returns a result_id. Reuse that ID for downstream analysis and dispose it when the workflow is complete.

Recommended call discipline

  1. Start with test_connection or health_check.
  2. Search/inspect entities instead of guessing IDs.
  3. Confirm the functional basis before calculation.
  4. Calculate once and reuse the result_id.
  5. Run result consistency checks before presenting decision-relevant numbers.
  6. Preserve database/method/amount/package/source context.
  7. Dispose the result when finished.