Execute MATLAB code.

Runs the given MATLAB code string in the session's engine. Returns a result dict with status, job_id, output, variables, etc.

Note: the ExecuteResult return annotation drives FastMCP's F6 output-schema generation. At runtime this returns a plain dict matching that schema, or — on MATLAB execution errors — a ToolResult(is_error=True). FastMCP passes ToolResult instances through untouched regardless of the declared return type (see fastmcp.tools.base.Tool.convert_result); annotating the return type as a bare union with ToolResult breaks schema generation entirely, so the annotation stays ExecuteResult only.

Lint MATLAB code using checkcode/mlint.

Writes the code to a temporary file and runs mcp_checkcode() on it, returning a list of issues (line, column, message, severity).

Note: see execute_code above for why the return annotation is CheckResult (not a union with ToolResult).

Get workspace variables for the current session.

Runs 'whos' in MATLAB and returns the result.

Get the status of a MATLAB execution job.

Returns status, timing info, and optional progress (from .progress file) for running jobs.

Get the full result of a completed MATLAB execution job.

Returns the result dict for completed jobs, or the error dict for failed jobs.

Cancel a pending or running MATLAB execution job.

Attempts to cancel the underlying MATLAB future and marks the job as cancelled in the tracker.

List all jobs for the current session.

Returns a list of job summaries including status and timing.

List available MATLAB toolboxes.

Runs 'ver' in MATLAB and returns the output along with toolbox configuration info.

List functions in a MATLAB toolbox.

Runs 'help ' in MATLAB and returns the output.

Get help text for a MATLAB function.

Runs 'help ' in MATLAB and returns the documentation.

Upload a data file to the session's temporary directory.

The file content should be base64-encoded. The file is written to the session temp dir and can be accessed from MATLAB code.

Delete a file from the session's temporary directory.

Only files in the session temp directory can be deleted.

List files in the session's temporary directory.

Returns names, sizes, and paths for all files in the session temp dir.

Read a MATLAB .m script file from the session's temporary directory.

Returns the file content as text. Use list_files to see available files.

Read a data file (.mat, .csv, .json, .txt, .xlsx) from the session temp directory.

For .mat files, 'summary' mode shows variable names/sizes/types via MATLAB, 'raw' mode returns base64-encoded content. Text files return inline content.

Read an image file (.png, .jpg, .gif) from the session temp directory.

Returns the image as an inline content block that renders in agent UIs.

Get the current status of the MATLAB engine pool.

Returns the total, available, busy, and max engine counts.

Get comprehensive server metrics including pool, jobs, sessions, and system stats.

Get server health status with issue detection. Returns healthy/degraded/unhealthy.

Get recent server errors and notable events for diagnosing issues.