Skip to content
Engineering Decision Intelligence
Documentation menu
ReferenceVersion 0.4.1

Troubleshoot openLCA MCP

Checks for missing tools, openLCA connection errors, read-only blocks, remote streaming, and stale result handles.

The server starts but the client shows no tools

  • Check the Python environment.
  • Check the working directory when using python -m src.
  • Check whether the client expects stdio or Streamable HTTP.
  • Refresh the client's tool catalog.

MCP connects but openLCA calls fail

  1. Confirm openLCA Desktop is running.
  2. Confirm the correct database is open.
  3. Confirm the IPC server is running.
  4. Check OPENLCA_HOST and OPENLCA_PORT.
  5. Run test_connection.

Write calls return WRITE_BLOCKED

The server is in read-only mode. Leave this enabled unless you intentionally need to create or modify database entities.

text
OPENLCA_READ_ONLY=true

A remote client connects but the stream fails

  • Check the MCP endpoint URL.
  • Check that the reverse proxy supports long-lived streaming responses.
  • Check TLS and authentication.
  • Reconnect and refresh the client tool catalog.

A result ID is stale

Run a fresh calculation after a server restart or a material model change. Dispose old results when they are no longer needed.