Run Table
openl_run_tableRun a business-rule table with your JSON input and retrieve its result. This starts Studio's run, waits for completion, and sends progress notifications instead of requiring polling.
Instructions
Execute a regular (non-Test) table with caller-provided JSON and return its result. This is a single high-level operation: it starts Studio's asynchronous run and waits inside the tool call until the result is ready, emitting progress notifications instead of requiring agent-side polling. Pass inputJson as an object keyed by method parameter name or as { params: { parameterName: value }, runtimeContext? }; { params: [...] } is rejected because Studio silently runs it with null arguments. A top-level array is passed as the value of a single array-valued parameter, not as positional arguments. Set withSchema only when the result/parameter JSON Schemas are needed because they can be large. Studio permits one table run per HTTP session, so wait for an active call to finish before starting another. Use openl_start_project_tests and the test-result tools for Test tables. Cancelling the MCP call also cancels and clears the Studio run.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tableId | Yes | Table ID of a regular executable table. Use openl_list_tables() to discover it; use the Tests tools instead for Test tables. | |
| inputJson | Yes | Method input as JSON. Use an object keyed by method parameter name, or { params: { parameterName: value }, runtimeContext? }. A top-level array is the value of a single array-valued parameter, not a positional argument list. The value is sent to Studio unchanged. | |
| projectId | Yes | Project ID returned by backend. Use the exact 'projectId' value from openl_list_projects() response without modification or reformatting. | |
| timeoutMs | No | Maximum time for the complete Studio start-and-result workflow, in milliseconds. Default 120000 (2 minutes), maximum 600000 (10 minutes). A timeout cancels the pending Studio run. | |
| fromModule | No | Optional module name whose runtime context should be used. Usually omit; discover module names with openl_list_project_modules(). | |
| withSchema | No | Include result and parameter JSON Schemas. Default false because schemas can be large. | |
| response_format | No | Response format: 'json' for structured, round-trippable data (default), 'markdown' for human-readable output, 'markdown_concise' for a brief summary (1-2 paragraphs), or 'markdown_detailed' for full details with context | json |